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我 试图 通过 这 本 书 与 世人 分 享 我 从 黑客 变 成 软件 工程 师 的 过 程 。 本 书 主 要 介绍 测试 ， 但 很 
快 你 就 会 发 现 ， 除 此 之 外 还 有 很 多 其 他 内 容 。 


感谢 你 阅读 本 书 。 


如 果 你 购买 了 本 书 ， 我 十 分 感激 。 如 果 你 看 的 是 免费 在 线 版 ， 我 仍然 要 感谢 你 ， 因 为 你 确 
定 这 本 书 值得 花 时 间 来 阅读 。 谁 知道 呢 ， 说 不 定 等 你 读 完 之 后 ， 会 决定 为 自己 或 朋友 买 一 
本 实体 书 。 

如 果 你 有 任何 评论 、 疑 问 或 建议 ， 希 望 你 能 写 信 告诉 我 。 你 可 以 通过 电子 邮件 直接 和 我 
联系 ， 地 址 是 obeythetestinggoat@gmail.com; 或 者 在 Twitter 上 联系 我 ， 我 的 用 户 名 是 


@hjwp。 你 还 可 以 访问 本 书 的 网 站 和 博客 (http://www.obeythetestinggoat.com/)， 以 及 邮 
件 列表 (https://groups.google.com/forum/#!forum/obey-the-testing-goat-book)。 

































































希望 阅读 本 书 能 让 你 身心 愉悦 ， 就 像 我 在 写作 本 书 时 感到 享受 一 样 。 


为 什么 要 与 一 本 关于 测试 驱动 开发 的 书 
我 知道 你 会 问 ,“ 你 是 谁 ， 为 什么 要 写 这 本 书 ， 我 为 什么 要 读 这 本 书 ? 


我 至 今 仍 然 处 在 编程 事业 的 初期 。 人 们 说 ， 不 管 从 事 什 么 工作 ， 都 要 历经 从 新 手 到 熟 手 的 
过 程 ， 最 终 有 可 能 成 为 大 师 。 我 要 说 的 是 ， 我 最 多 算是 个 熟练 的 程序 员 。 但 我 很 幸运 ， 在 
事业 的 早期 阶段 就 结识 了 一 群 测 试 驱 动 开发 (TestDriven Development，TDD) 的 狂热 爱 
好 者 ， 这 对 我 的 编程 事业 产生 了 极 大 影响 ， 让 我 迫不及待 地 想 和 所 有 人 分 享 这 段 经 历 。 可 
以 说 ， 我 很 积极 地 做 出 了 最 近 这 次 转变 ， 而 且 这 有 段 学 习 经 历 现 在 还 历历 在 目 ， 我 希望 能 让 
初学 者 感同身受 。 
































我 在 开始 学 习 Python 时 (看 的 是 Mark Pilgrim 写 的 Dive Into Python)， 偶 然 知道 了 TDD 的 
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概念 。 我 当时 就 认为 :“ 是 的 ， 我 绝对 知道 这 个 概念 的 意义 所 在 。 或 许 你 第 一 次 听 阅 TDD 
时 也 有 类 似 的 反应 吧 。 它 听 起 来 像 是 一 个 非常 合理 的 方案 ， 一 个 需要 养 成 的 非常 好 的 习 
惯 一 一 就 像 经 常 刷牙 之 类 的 习惯 。 


随后 我 做 了 第 一 个 大 型 项 目 。 你 可 能 猜 到 了 ， 有 项 目 就 会 有 客户 ， 有 最 后 期 限 ， 有 很 多 事 
情 要 做 。 于 是 ， 所 有 关于 TDD 的 好 想法 被 抛 诸 脑 后 。 

的 确 ， 这 对 项 目 没 什么 影响 ， 对 我 也 没 影响 。 

人 
一 开始 ， 我 知道 并 不 真 的 需要 使 用 TDD， 因 为 我 做 的 是 个 小 网 站 ， 手 动 检查 就 能 轻易 测试 
出 是 否 能 用 。 在 这 儿 点 击 链 接 ， 在 那儿 选中 下 拉 菜 单 选项 ， 就 应 该 有 预期 的 效果 。 很 简单 。 
编写 整套 测试 程序 听 起 来 似乎 要 花费 很 长 时 间 ， 而 且 ， 经 过 整整 三 周 成 熟 的 代码 编写 经 历 ， 
我 自负 地 认为 自己 已 经 成 为 一 名 出 色 的 程序 员 了 。 我 能 顺利 完成 这 个 项 目 。 这 没什么 难度 。 
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只 是 在 初期 如 此 oO 
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随后 ， 项 目 变 得 复杂 得 可 怕 ， 这 很 快 暴露 了 我 的 经 验 不 足 。 





项 目 不 断 变 大 。 系 统 的 不 同 部 分 之 间 要 开始 相互 依赖 。 我 尽量 遵守 良好 的 开发 原则 ， 例 如 
“不 要 自我 重复 ”(Don’t Repeat Yourself，DRY)， 却 被 带 进 了 一 片 危险 地 带 。 我 很 快 就 用 
到 了 多 重 继承 ， 类 的 继承 有 八 个 层级 深 ， 还 用 到 了 eval 语句 。 











我 不 敢 修 改 代码 ， 不 再 像 以 前 一 样 知道 什么 依赖 什么 ， 也 不 知道 修改 某 处 的 代码 可 能 会 导 
致 什么 后 果 。 噢 ， 天 呐 ， 我 觉得 那 部 分 继承 自 这 里 ， 不 ， 不 是 继承 ， 是 重新 定义 了 ， 可 是 
却 依 赖 那个 类 变量 。 嗯 ， 好 吧 ， 如 果 我 再 次 重 定义 以 前 重 定义 的 部 分 ， 应 该 就 可 以 了 。 我 
会 检查 的 ， 可 是 检查 变 得 更 难 了 。 网 站 中 的 内 容 越 来 越 多 ， 手 动 点 击 变 得 不 切实 际 了 。 最 
好 别 动 这 些 能 运行 的 代码 ， 不 要 重 构 ， 就 这 么 凑合 吧 。 



































很 快 ， 代 码 就 变 得 像 一 团 床 ， 丑 陋 不 堪 。 开 发 新 功能 变 得 很 痛苦 。 














在 此 之 后 不 入 ， 我 幸运 地 在 Resolver Systems 公司 (现在 叫 PythonAnywhere，https:Wwww. 
pythonanywhere.com/) 找到 了 一 份 工作 。 这 个 公司 遵循 极限 编程 (Extreme Programming， 
XP) 开发 理念 。 他 们 向 我 介绍 了 严密 的 TDD。 











虽然 之 前 的 经 验 的 确 让 我 认识 到 自动 化 测试 的 好 处 ， 但 我 在 每 个 阶段 都 心 存疑 虑 。" 我 的 
意思 是 ， 测 试 通 常 来 说 可 能 是 个 不 错 的 主意 ， 但 果真 如 此 吗 ? 全 部 都 要 测试 吗 ? 有 些 测 试 
看 起 来 完全 是 在 浪费 时 间 …… 什 么 ?除了 单元 测试 之 外 还 要 做 功能 测试 ? 得 了 吧 ， 这 是 多 
此 一 举 ! 还 要 走 一 遍 测 试 驱 动 开 发 中 的 “测试 /小 幅度 代码 改动 /测试 "循环 ? 太 充 户 了 ! 
我 们 不 需要 这 种 婴儿 学 步 般 的 过 程 ! 既然 我 们 知道 正确 的 答案 是 什么 ， 为 什么 不 直接 跳 到 
最 后 一 步 呢 ?” 















































相信 我 ! 我 审视 过 每 一 条 规则 ， 给 每 一 条 捷径 提出 过 建议 ， 为 TDD 的 每 一 个 看 似 毫 无 意 
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xvi 用 后 


义 的 做 法 寻找 过 理由 ， 最 终 ， 我 发 现 了 采用 TDD 的 明智 之 处 。 我 记 不 清 在 心里 说 过 多 少 


次 











“谢谢 你 ， 测 试 ”， 因 为 功能 测试 能 揭示 我 们 可 能 永远 都 无 法 预测 的 回归 ， 单 元 测试 能 





让 我 避免 犯 很 思春 的 逻辑 错误 。 从 心理 学 上 讲 ，TDD 大 大 减少 了 开发 过 程 中 的 压力 ， 而 且 
写 出 的 代码 让 人 和 赏心悦目。 


那么 ， 让 我 告诉 你 关于 TDD 的 一 切 吧 ! 


写作 本 书 的 目的 


我 写 这 本 书 的 主要 目的 是 要 传授 一 种 用 于 Web 开发 的 方法 ， 它 可 以 让 Web 应 用 变 得 更 好 ， 
也 能 让 开发 者 更 愉快 。 一 本 书 如 果 只 包含 一 些 上 网 搜索 就 能 找到 的 知识 ， 那 它 就 没 多 大 的 


所 | 











意思 了 ， 所 以 本 书 不 是 Python 句法 指南 ， 也 不 是 Web 开发 教程 。 我 希望 教会 你 的 ， 是 如 





何 使 用 TDD 理念 ， 更 加 稳妥 地 实现 我 们 共同 的 神圣 目标 一 一 简洁 可 用 的 代码 。 








即便 如 此 ， 我 仍 会 从 零 开始 使 用 Django、Selenium、jQuery 和 Mock 等 工具 开发 一 个 Web 


应 用 ， 不 断 提 到 一 个 真实 可 用 的 示例 。 阅 读本 书 之 前 ， 你 无 需 了 解 这 些 工 具 。 读 完 本 书 
后 ， 








你 会 充分 了 解 这 些 工具 ， 并 掌握 TDD 理念 。 








在 极限 编程 实践 中 ， 我 们 总 是 结对 编程 。 写 这 本 书 时 ， 我 设想 自己 和 以 前 的 自己 结 成 对 





子 ， 向 以 前 的 我 解释 如 何 使 用 这 些 工 具 ， 回 答 为 什么 要 用 这 种 特别 的 方式 编写 代码 。 所 
以 ， 如 果 我 表现 得 有 点 儿 届 尊 俯 就 ， 那 是 因为 我 不 是 那么 聪明 ， 我 要 对 自己 很 有 耐心 。 如 
果 觉 得 我 说 话 冒 犯 了 你 ， 那 是 因为 我 有 点 儿 烦 人 ， 经 常 不 认同 别人 的 说 法 ， 所 以 有 时 要 花 
很 多 时 间 论 证 ， 说 服 自己 接受 他 人 的 观点 。 


本 书 结构 


我 将 这 本 书 分 成 了 三 个 部 分 。 














第 一 部 分 (第 1~6 章 ) : 基础 知识 

开门 见 山 ， 介 绍 如 何 使 用 TDD 开发 一 个 简单 的 Web 应用。 我 们 会 先 (用 Selenium) 写 
一 个 功能 测试 ， 然 后 介绍 Django 的 基础 知识 ， 包 括 模 型 、 视 图 和 模板 。 在 每 个 阶段 ， 
我 们 都 会 编写 严格 的 单元 测试 。 除 此 之 外 ， 我 还 会 向 你 引荐 测试 山羊 。 














第 二 部 分 (第 7~14 章 ) : Web 开发 要 素 
介绍 Web 开发 过 程 中 一 些 环 手 但 不 可 避免 的 问题 ， 并 展示 如 何 通过 测试 解决 这 些 问题 ， 
包括 静态 文件 、 部 署 到 生产 环境 、 表 单数 据 验 证 、 数 据 库 迁移 和 令 人 旦 惧 的 JavaScript。 











部 分 (第 15~20 章 ) : 高 级 话题 
介绍 模拟 技术 、 集 成 第 三 方 认证 系统 、Ajax、 测 试 固 件 、 由 外 而 内 的 TDD 流程 ， 以 及 
持续 集成 (Continuous Integration ，CIT) 。 











此 





下 


排版 约定 
本 书 使 用 了 下 列 排版 约定 。 
比 


楷体 
表示 新 术语 或 强调 的 内 容 。 


下 说 明 一 


杂 务 。 











等 宽 字 体 (Constant width ) 
表示 程序 片段 ， 以 及 正文 中 出 现 的 变量 、 
和 关键 字 等 。 


加 粗 等 宽 字 体 (Constant width botLd) 
表示 应 该 由 用 户 输入 的 命令 或 其 他 文本 。 


偶尔 使 用 [.….] 符号 表示 省 略 了 一 些 内 容 ， 截 断 较 长 的 输 





图 标 表示 提示 或 和 





EX 。 





图 标 表示 提示 、 罗 





E 议 或 一 般 注 记 。 


Re 





图 标 表 示警 告 或 警示 。 





使 用 代码 示例 


函数 名 、 数 据 库 、 数 据 类 


4， 或 者 跳 到 相关 的 内 容 。 





代码 示例 可 到 https://github.com/hjwp/book-example/ 下 载 ， 各 章 的 代码 都 放 在 单独 的 分 支 
中 (例如 ，https://github.com/hjwp/book-example/tree/chapter_03)。 每 一 章 的 结尾 都 有 一 些 





建议 ， 告 诉 你 如 何 使 用 这 个 仓库 。 
本 书 是 要 帮 你 完成 工作 的 。 一 般 来 说 ， 如 果 本 二 








BB 提供 了 示例 代码 ， 你 可 以 把 它 用 在 你 的 程 


序 或 文档 中 。 除 非 你 使 用 了 很 大 一 部 分 代码 ， 否 则 无 需 联 系 我 们 获得 许可 。 比 如 ， 用 本 书 








的 几 个 代码 片段 写 一 个 程序 就 无 需 获 得 许可 ， 销 售 或 分 发 O'Reilly 图 书 的 示例 光盘 则 需要 
获得 许可 ， 引 用 本 书 中 的 示例 代码 回答 问题 无 需 获 得 许可 ， 将 书 中 大 量 的 代码 放 到 你 的 产 
品 文档 中 则 需要 获得 许可 。 


我 们 很 希望 但 并 不 强制 要 求 你 在 引用 本 书 内 容 时 加 上 引用 说 明 。 引 用 说 明 一 般 包 括 书 
名 、 作 者 、 出 版 社 和 ISBN。 比 如 :“7est-Driven Development with Python by Harry Percival 
(O’Reilly). Copyright 2014 Harry Percival, 978-1-449-36482-3.” 











如 果 你 觉得 自己 对 示例 代码 的 用 法 超出 了 上 述 许可 的 范围 ， 欢 迎 你 通过 permissions@ 
oreilly.com 与 我 们 联系 。 














Safari? Books Online 

















9Safari Books Online (http /www.safaribooksonline.com) 是 应 

Gafarl 运 而 生 的 数字 图 书馆 。 它 同时 以 图 书 和 视频 的 形式 出 版 世界 

Tafl 顶级 技术 和 商务 作家 的 专业 作品 。 技 术 专 家 、 软 件 开 发 人 员 、 

Web 设计 师 、 商 务 人 士 和 创意 专家 等 ， 在 开展 调研 、 解 决 问题 、 学 习 和 认证 培训 时 ， 都 
将 Safari Books Online 视 作 获取 资料 的 首选 渠道 。 




















对 于 组 织 团体 、 政 府 机 构 和 个 人 ，Safari Books Online 提供 各 种 产品 组 合 和 灵活 的 定 
价 策略 。 用 户 可 通过 一 个 功能 完备 的 数据 库 检 索 系 统 访问 O'Reilly Media、Prentice 
Hall Professional、 Addison-Wesley Professional、 Microsoft Press、Sams、Que、Peachpit 





Press、 Focal Press、 Cisco Press、 John Wiley & Sons、 Syngress、 Morgan Kaufmann、IBM 
Redbooks、 Packt、Adobe Press、FT Press、Apress、Manning、New Riders、McGraw-Hill、 
Jones && Bartlett、Course Technology 以 及 其 他 几 十 家 出 版 社 的 上 千 种 图 书 、 培 训 视 频 和 正 
式 出 版 之 前 的 书稿 。 要 了 解 Safari Books Online 的 更 多 信息 ， 我 们 网 上 见 。 


联系 我 们 
请 把 对 本 书 的 评价 和 问题 发 给 出 版 社 。 


美国 : 
O’Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 
北京 市 西城 区 西直门 南大 街 2 号 成 馈 大 厦 C 座 807 室 (100035) 
奥 莱 利 技术 咨询 (北京 ) 有限 公司 





























O’Reilly 的 每 一 本 书 都 有 专属 网 页 ， 你 可 以 在 那儿 找到 本 书 的 相关 信息 ， 包 括 勘 误 表 、 














例 代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : 
hhttp://shop.oreilly.com/product/0636920029533.do 











对 于 本 书 的 评论 和 技术 性 问题 ， 请 发 送 电 子 邮件 到 ; bookquestions@oreilly.com。 








要 了 解 更 多 O'Reilly 图 书 、 培 训 课 程 、 会 议和 新 闻 的 信息 ， 请 访问 以 下 网 站 : 


http://www.oreilly.com 








我 们 在 Facebook 的 地 址 如 下 : http://facebook.com/oreilly 





请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia 


我 们 的 YouTube 视频 地 址 如 下 : http://www.youtube.com/oreillymedia 





到 
了 





准备 工作 和 应 具备 的 知识 


我 假设 读者 具备 了 如 下 的 知识 ， 





电脑 中 还 应 该 安装 一 些 软件 。 


了 解 Python 3， 会 编程 


写 这 本 书 时 ， 我 考虑 到 了 初学 者 











。 但 如 果 你 刚 接 触 编程 ， 我 假设 你 已 经 学 习 了 Python 基础 知 





识 。 如 果 还 没 学 ， 请 阅读 一 份 Python 初学 者 教程 ， 或 者 买 一 本 入 门 书 ， 比 如 Dive Into Python 
(http://www.diveintopython.net/) 或 Learn Python the Hard Way (http://learnpythonthehardway.org/), 
或 者 出 于 兴趣 ， 看 一 下 Invent Your Own Computer Games with Python (http://inventwithpython. 


com/)。 这 三 本 都 是 很 好 的 入 门 


如 果 你 是 经 验 丰 富 的 程序 员 ， 但 刚 接触 Python， 阅 读本 书 应 该 没 问 题 。Python 简单 易 懂 。 


本 书 中 我 用 的 是 Python 3。 我 在 





。 











2013~2014 年 写 这 本 书 时 ，Python 3 已 经 发 布 好 几 年 了 ， 全 








世界 的 开发 者 正 处 在 一 个 拐点 上 ， 他 们 更 倾向 于 选择 使 用 Python 3。 可 以 参照 本 书 内 容 在 


Mac、Windows 和 Linux 中 实践 。 


本 书 内 容 在 Python 


在 各 种 操作 系统 中 安装 Python 的 详细 说 明 后 文 会 介绍 。 


3.3 和 Python 3.4 中 测试 过 。 如 果 出 于 某 些 原因 ， 你 使 用 





的 是 Python 3.2， 可 能 会 发 现 细微 的 差别 ， 所 以 如 果 可 以 ， 最 好 升级 Python。 








我 不 建议 使 用 Python 2， 因 为 它 和 Python 3 之 间 的 区 别 太 大 。 如 果 了 碰巧 你 的 下 一 个 项 目 使 用 
的 是 Python 2， 仍 然 可 以 运用 从 本 书 中 学 到 的 知识 。 不 过 ， 当 你 得 到 的 程序 输出 和 本 书 不 一 


样 时 ， 要 花 时 间 判 断 是 因为 用 了 


如 果 你 想 使 用 PythonAnywhere 





Python 2， 还 是 因为 你 确实 犯 了 错 一 一 这 么 做 太 浪费 时 间 了 。 


(https://www.pythonanywhere.com/， 这 是 我 就 职 的 PaaS 创 


业 公 司 ) ， 不 愿 在 本 地 安装 Python， 可 以 先 快速 阅读 一 遍 附录 A。 
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无 论 如 何 ， 我 希望 你 能 使 用 Python， 知 道 如 何 从 命令 行 启动 Python (一 般 使 用 python3 命 
令 )， 也 知道 如 何 编辑 和 运行 Python 文件 。 再 次 提醒 ， 如 果 你 有 任何 疑问 ， 看 一 下 我 在 前 
面 推荐 的 三 本 书 。 














如 果 你 已 经 安装 了 Python 2， 担 心 再 安装 Python 3 会 破坏 之 前 的 版 本 ， 那 大 
可 以 放心 ，Python 3 和 Python 2 可 以 相安 无 事 地 共存 于 同一 个 系统 中 ， 而 且 
这 两 个 版 本 存储 代码 包 的 位 置 完全 不 一 样 。 你 只 需 确保 有 一 个 启动 Python 3 
的 命令 (python3)， 还 有 一 个 启动 Python 2 的 命令 (通常 就 是 python)。 类 
似 地 ， 在 Python 3 中 安装 pip 时 ， 我 们 要 保证 它 的 命令 (通常 是 pip3) 和 
Python 2 的 不 一 样 。 








HTML 的 工作 方式 


我 还 假定 你 基本 了 解 Web 的 工作 方式 ， 知 道 什么 是 HTML、 什 么 是 POST 请 求 等 。 如 果 
你 对 这 些 概念 不 熟悉 ， 那 么 需要 找 一 份 HTML 基础 教程 看 一 下 ，http://www.webplatform. 
org/ 上 列 出 了 一 些 。 如 果 你 知道 如 何在 电脑 中 创建 HTML 页 面 ， 并 在 浏览 器 中 查看 ， 也 知 
道 表单 以 及 它 的 工作 方式 ， 那 么 或 许 你 就 符合 我 的 要 求 。 

















JavasScript 


本 书后 半 部 分 有 少量 JavaScript。 如 果 你 不 了 解 JavaScript， 先 别 担心 。 如 果 你 觉得 有 些 看 
不 懂 ， 到 时 我 会 推荐 一 些 参 考 资料 给 你 。 


需要 安装 的 软件 
除了 Python 之 外 ， 还 要 安装 以 下 软件 。 





。 Firefox Web 浏览 器 

在 谷歌 中 搜索 一 下 就 能 找到 适合 你 所 用 平台 的 安装 程序 。Selenium 其 实 能 驱动 任意 一 款 
主流 浏览 器 ， 不 过 以 Firefox 举例 最 简单 ， 因 为 它 跨 平台 。 而 且 使 用 Firefox 还 有 另外 一 
个 好 处 一 一 和 公司 利益 没有 多 少 关联 。 








。 Git 版 本 控制 系统 
Git 可 在 任何 一 个 平台 上 使 用 ， 下 载 地 址 是 http://git-scem.com/。 





。 Python 包 管 理工 具 pip 
Python 3.4 集成 了 pip (之 前 的 版 本 都 没 集成 ， 这 是 一 大 进步 )。 为 确保 使 用 Python 3 中 
的 pip， 我 总 是 会 在 命令 行 中 使 用 可 执行 文件 pip3。 在 你 使 用 的 系统 中 ， 这 个 可 执行 文 
件 可 能 是 pip-3.4 或 者 pip-3.3。 更 多 信息 请 阅读 针对 各 种 操作 系统 的 详细 说 明 。 
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针对 Windows 的 说 明 


Windows 用 户 有 时 会 觉得 被 忽略 了 ， 因 为 OS X 和 Linux 的 存在 很 容易 让 人 忘记 在 
Unix 之 外 还 有 一 个 世界 。 使 用 反 儿 线 作为 目录 分 隔 符 ? 盘 符 ?这 些 是 什么 ? 不 过 ， 赔 
读本 书 时 仍然 可 以 在 Windows 中 实践 。 下 面 是 一 些小 提示 。 


1. 在 Windows 中 安装 Git 时 ， 一定 要 选择 “Run Git and included Unix tools from the 
Windows command prompt”( 在 Windows 命令 提示 符 中 运行 Git 和 所 含 的 Unix 工 
)。 选 择 这 个 选项 之 后 就 能 使 用 Git Bash 了 。 把 Git Bash 作为 主要 命令 提示 符 ， 
你 就 能 使 用 所 有 实用 的 GNU 命令 行 工 具 ， 例 如 1s、touch 和 grep， 而 且 目录 分 隔 

符 也 使 用 斜 线 表 示 。 


2. 安装 Python 3 时 ， 一 定 要 选中 “Add python.exe to Path”( 把 python.exe 添加 到 系统 
路 径 中 )， 这 么 做 才能 在 命令 行 中 运行 Python。 如 图 P-1 所 示 。 





瘟 Python 3.4.0 Setup 
Customize Python 3.4.0 


Select the way you want features to be installed. 
Click on the icons in the tree below to change the 
way features wil be installed， 








Register Extensions 

TclTk 

Documentation 

Utility Scripts 

pip 

Test suite 

add python,exe to Path 二 

鲜 Wilbe installed on local hard drive 

Prepend CAF Ba Entire feature will be installed on local harc 
variable, This 
command prl x Entire feature willbe unavailable 


This feature requires OKB on your hard dive， 


windows 














图 P-1: 从 安装 程序 将 Python 加 入 系统 路 径 


3. 在 Windows 中 ， Python 3 的 可 执行 文件 是 python.exe， 和 Python 2 的 完全 一 样 。 为 
了 避免 混淆 ， 请 在 Git Bash 的 二 进 制 文件 夹 中 创建 一 个 符号 链接 ， 方 法 如 下 : 
Ln -s /c/Python34/python.exe /bin/python3.exe 
你 可 能 需要 在 Git-Bash 上 点 击 右键 ,选择 “以 管理 员 身 份 运行 ， 这 么 做 上 述 命 令 


述 
才能 生效 。 还 要 注意 ， 这 个 符号 链接 只 在 Git Bash 中 有 效 ， 在 常规 的 DOS 命令 提 
示 符 中 不 可 用 。 
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4. Python 3.4 集成 了 包 管 理工 具 pip。 你 可 以 在 命令 行 中 执行 which pip3 查看 是 否 安 
装 了 pip， 这 个 命令 应 该 返回 /c/Python34/Scripts/pip3。 


如 果 出 于 某 种 原因 ， 在 Python 3.3 中 遇 到 了 问题 ,或 者 没有 安装 ptp3， 请 访问 http:/ 
wwWwpip-installerorg/， 查 看 安装 说 明 。 写 作 本 书 时 ， 安 装 pip3 的 方法 是 ， 下 载 一 个 
文件 ， 然 后 执行 python3 get-pip.py 命令 。 运 行 安装 脚本 时 ， 确 保 使 用 的 是 python3。 


测试 所 有 软件 是 否 正 确 安装 的 方法 是 ， 打 开 Git Bash 命令 提示 符 ， 在 
任意 一 个 文件 夹 中 执行 命令 python3 或 pip3。 




















针对 MacOS 的 说 明 


MacOS 比 Windows 稍微 正常 一 点 儿 ， 不 过 在 Python 3.4 之 前 ， 安 装 pip3 还 是 一 项 极 

具 挑 战 性 的 任务 。Python 3.4 发 布 后 ， 安 装 方法 变 得 简单 明了 。 

。 使 用 下 载 的 安装 程序 (https://www.python.org/) 就 能 安装 Python 3.4， 省 去 了 很 多 
麻烦 。 而 有 全， 这 个 安装 程序 也 会 自动 安装 pip。 

。 Git 安装 程序 也 能 顺利 运行 。 

测试 这 些 软件 是 否 正 常安 装 的 方法 和 Windows 类 似 打开 一 个 终端 ， 然 后 在 任意 

位 置 执行 命令 git、python3 或 ptp3。 如 果 遇 到 问题 ， 搜 索 关 键 字 “system path” 和 

“command not found”， 就 能 找到 解决 问题 的 合适 资源 。 


或 许 你 还 应 该 检验 一 下 Homebrew (http://brew.sh//)。 在 Mac 安装 众 
多 Unix 工具 的 方式 中 ， 它 是 唯一 可 信赖 的 。 虽 然 现在 Python 安装 程 
序 做 得 不 错 ， 但 将 来 你 可 能 会 用 到 Homebrew。 要 使 用 Homebrew， 
需 下 载 大 小 为 1.1 GB 的 Xcode。 不 过 这 有 个 好 处 你 得 到 了 一 个 
C 编译 器 。 





























Git 默 认 使 用 的 编辑 器 和 其 他 基本 配置 


后 文 我 会 逐步 介绍 如 何 使 用 Git， 不 过 现在 最 好 做 些 配 置 。 例 如 ， 首 次 提交 上 时， 默认 情况 
下 会 弹出 vi， 这 可 能 让 你 手足 无 措 。 鉴 于 vi 有 两 种 模式 ， 你 有 两 个 选择 。 其 一 ， 学 一 些 
基本 的 vi 命令 ( 按 i 键 进入 插入 模式 ,输入 文本 后 再 按 <Esc> 键 返 回 常 规模 式 ， 然 后 输 
入 :wq<Enter> 写 人 文件 并 退出 )。 学 会 这 些 命令 后 ， 你 就 加 入 了 一 个 互助 会 ， 这 里 的 人 们 
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知道 怎么 使 用 这 个 古老 而 让 人 蛇 敬 的 文本 编 人 


Em 


年 阅 


另外 一 个 选择 是 直接 拒绝 这 种 穿越 到 20 世纪 70 年 代 的 元 唐 行为 ， 而 是 配置 Git， 让 它 使 


用 你 选择 的 编辑 器 。 按 <Esc> 键 ， 再 输入 :q!， 退 上 





HH vi， 然后 修改 Git 使 用 的 默认 编辑 器 。 


具体 方法 参见 介绍 Git 基本 配置 的 文档 ， 网 址 是 http://git-sem.com/book/zh/Customizing-Git- 


Git-Configuration 。 





需要 安装 的 Python 模 块 


安装 好 pip 之 后 ， 再 安装 新 的 Python 模块 就 简单 了 。 接 下 来 ， 我 们 会 陆续 安装 一 些 模块 ， 
但 有 几 个 模块 一 开始 就 需要 ， 所 以 现在 就 应 该 安装 。 


。 Django 1.7，sudo pip3 install django==1.7 (在 Windows 中 不 需要 sudo)。 这 是 我 


们 要 使 用 的 Web 框架 。 


要 保证 你 安装 的 是 1.7 版 ， 而 且 能 在 命令 行 中 使 用 可 执行 文件 


django-admin.py。 如 果 需 要 帮助 ， 可 以 查看 Django 的 文档 ， 其 中 有 安装 说 明 ， 网 址 是 
https://docs.djangoproject.com/en/1.7/intro/install/。 





1.7.x.zip。 


截至 2014 年 5 月 ，Django 1.7 还 在 测试 阶段 。 如 果 上 述 命令 无 效 ， 请 执行 
sudo pip3 instaLL https://github.com/django/django/archive/stable/ 


。 Selenium，sudo pip3 instaLL --upgrade selenium ( 在 Windows 中 不 需要 sudo)。 


[le 


Selenium 是 浏览 器 


自动 化 工具 ， 我 们 要 用 它 来 驱动 功能 视 
Selenium 一 直 紧 跟 主 流 浏 








I PS 


网 太 























I 试 。 确 保 你 安装 的 是 最 新 版 。 
的 更 新 步伐 ， 尝 试 使 用 最 新 功能 。 如 有 果 你 发 现 Selenium 








由 于 某 些 原因 表现 异常 ， 通 常 都 是 因为 Firefox 的 版 本 太 新 ， 此 时 你 应 该 升级 到 最 新 版 








的 Selenium。 


用 到 vi 





rtuaLenv 。 








注 1: Django 1.7 于 2014 全 





E9 月 2 日 J 








E 式 发 布 ， 此 时 本 








ph 文 版 J 








E 在 翻译 中 。 一 一 译 者 注 


除非 确切 知道 你 在 做 什么 ， 否 则 不 要 使 用 virtualenv。 从 第 8 章 开 始 
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关于 IDE 


如 果 你 来 自 Java 或 .NET 领域 ， 可 能 非常 想 使 用 IDE (集成 开发 环境 ) 编写 Python 代 
码 。IDE 中 有 各 种 实用 的 工具 ， 例 如 VCS 集成 。Python 领域 也 有 一 些 很 棒 的 IDE。 刚 
开始 我 也 用 过 一 个 IDE， 我 发 现 它 对 我 最 初 的 几 个 项 目 很 有 用 。 


我 能 建议 (只 是 建议 ) 你 别 用 IDE 吗 ? 至 少 在 阅读 本 书 时 别 用 。 在 Python 领域 ，IDE 
不 是 那么 重要 。 写 作 这 本 书 时 ， 我 假定 你 只 使 用 一 个 简单 的 文本 编辑 器 和 命令 行 。 某 
些 时 候 ， 它 们 是 你 所 能 使 用 的 全 部 工具 (例如 在 服务 器 中 )， 所 以 刚 开始 时 值得 花 时 
间 学 习 使 用 基本 的 工具 ， 理 解 它 们 是 如 何 工作 的 。 即 便当 你 读 完 本 书后 决定 继续 使 用 
IDE 和 其 中 的 实用 工具 ， 这 些 基 本 的 工具 还 是 随手 可 得 。 








上 述说 明 对 你 没什么 用 吗 ? 或 者 你 有 更 好 的 说 明 ? 请 给 我 发 电子 邮件 吧 ， 地 


址 是 obeythetestinggoat@gmail.com。 
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第 一 部 分 
TDD 和 Djang0 基 础 





第 一 部 分 我 要 介绍 测试 驱动 开发 (TestDriven Development，TDD) 的 基础 知识 。 我 们 会 
从 零 开 始 开发 一 个 真实 的 Web 应 用 ， 而 且 每 个 阶段 都 要 先 写 测试 。 


这 一 部 分 涵盖 使 用 Selenium 完成 的 功能 测试 ， 以 及 单元 测试 ， 还 会 介绍 二 者 之 间 的 区 别 。 
J TDD 流程 ,我 称 之 为 “单元 测试 / 编写 代码 ”循环 。 说 明 怎 

么 结合 TDD 使 用 。 因 为 版 本 控制 对 重要 的 软件 工程 来 说 是 基本 需求 ， 所 以 我 们 还 会 用 到 
版 本 控制 系统 (Git)。 我 会 介绍 何 时 以 及 如 何 提 交 ， 如 何 把 提交 集成 到 TDD 和 Web 开发 
的 流程 中 。 








我 们 要 使 用 Django， 它 i 是 Python 领域 之 中 最 受 欢迎 的 Web 框架 。 我 会 试 着 慢 慢 
介绍 Django 的 概念 ， 一 次 一 个 ， 除 此 之 外 还 会 提供 很 多 扩展 阅读 资料 的 链接 ， 如 果 你 完 
pa Django, NY WT A : 花 时 间 阅 读 这 些 资料 。 如 果 你 感觉 有 点 儿 茫 然 ， 花 

儿 小 时 读 一 遍 Django 的 官方 教程 ， 然 后 再 回来 阅读 本 书 。 


你 还 会 结识 测试 山羊 …… 





复制 粘贴 时 要 小 心 


如 果 你 看 的 是 电子 版 ， 那 么 在 阅读 的 过 程 之 中 就 会 很 自然 地 会 想 要 复制 粘贴 
书 中 的 代码 清单 。 如 果 不 这 么 做 的 话 效果 会 更 好 : 动手 输入 能 形成 肌肉 记 
忆 ， 感觉 也 更 真实 。 你 偶尔 会 打 错字 ， 这 是 无 法 避免 的 ， 调 试 错误 也 是 一 项 
需要 学 习 的 重要 技能 。 











除 此 之 外 ， 你 还 会 发 现 PDF 格式 相当 诡异 ， 复 制 粘贴 时 经 常会 有 意 想不到 的 
事情 发 生 A 





第 一 部 分 


第 1 章 


使 用 功能 测 研 协助 安 准 Django 





TDD 不 是 天 生 就 会 的 技术 ， 和 武术 一 样 是 一 种 技能 。 而 且 就 像 在 功夫 电影 中 一 样 ， 你 需要 
一 个 脾气 不 好 、 不 可 理喻 的 师 传 来 强制 你 学 习 。 我 们 的 师傅 是 测试 山羊 。 


1.1 遵从 测试 山手 的 教诲 ， 没 有 测试 什么 也 别 做 
在 Python 测试 社区 中 ,测试 山羊 是 TDD 的 非 官方 吉祥 物 。 测 试 山羊 对 不 同 的 人 有 不 同 的 
意义 。 对 我 来 说 ， 它 是 我 脑海 中 的 一 个 声音 ， 告 诉 我 要 一 直 走 在 测试 这 条 正确 的 道路 上 ， 
就 像 卡 遂 片 中 在 肩膀 上 浮现 的 天 使 或 魔鬼 一 样 ， 只 是 没 那 么 吊 吊 盈 人 。 我 希望 借 由 这 本 
书 ， 让 测试 山羊 也 扎根 于 你 的 脑海 中 。 

虽然 还 不 太 确 定 要 做 什么 ,但 我 们 已 经 决定 要 开发 一 个 网 站 。Web 开发 的 第 一 步 通常 是 
安装 和 配置 Web 框架 。 下 载 这 个 ， 安 装 那 个 ， 配 置 那 个 ， 运 行 这 个 脚本 …… 但 是 ， 使 用 
TDD 时 要 转换 思维 方式 。 做 测试 驱动 开发 时 ， 你 的 心里 要 一 直 记 着 测试 山羊 ， 像 山羊 一 样 
专注 ， 哇 哇 地 岂 着 :“ 先 测试 ， 先 测试 ! ” 

在 TDD 的 过 程 中 ， 第 一 步 始 终 一 样 : 编写 测试 。 









































首先 要 编写 测试 ， 然 后 运行 ， 看 是 否 和 预期 一 样 失败 ， 只 有 失败 了 才能 继续 下 一 步 
写 应 用 程序 。 请 模仿 山羊 的 声调 复述 这 个 过 程 。 我 就 是 这 么 做 的 。 





编 

















山羊 的 另 一 个 特点 是 一 次 只 迈 一 步 。 因 此 ， 不 管 山 壁 多 么 陡峭 ， 它 们 都 不 会 跌落 。 看 看 图 
1-1 里 的 这 只 山羊 ! 


























图 1-1: 山羊 比 你 想象 的 要 机 敏 (来 源 : Flickr 用 户 Caitlin Stewart，http://www .flickr.com/photos/ 
caitlinstewart/2846642630/) 


我 们 会 碎 步 向 前 。 使 用 流行 的 Python Web 框架 Django 开发 这 个 应 用 。 


首先 ， 要 检查 是 否 安装 了 Django， 并 且 能 够 正常 运行 。 检 查 的 方法 是 ， 在 本 地 电脑 中 能 
否 启动 Django 的 开发 服务 器 ， 并 在 浏览 器 中 查看 能 否 打开 网 页 。 使 用 浏览 器 自动 化 工具 


Selenium 完成 这 个 任务 。 





在 你 想 保存 项 目 代码 的 地 方 新 建 一 个 Python 文件 ， 命 名 为 functional_tests.py， 并 输入 以 下 
代码 。 如 果 你 喜欢 一 边 输入 代码 一 边 像 山羊 那样 轻声 念 叫 ， 或 许 会 有 所 帮助 








from selenium import webdriver 


browser = webdriver.Firefox() 
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browser .get('http://LocaLhost:8000 ' ) 


assert 'Django' in browser .tittLe 





别 了 ， 有 罗马 数字 
很 多 介绍 TDD 的 文章 都 喜欢 以 罗马 数字 为 例 ， 阅 了 笑话 ， 黄 至 我 一 开始 也 是 这 么 写 
的 。 如 果 你 好 奇 ， 可 以 查看 我 在 GitHub 的 页 面 ， 地 址 是 https://github.com/hjwp/。 
以 罗马 数字 为 例 有 好 也 有 坏 。 把 问题 简化 ， 合 理 地 限制 在 某 一 范围 内 ， 让 你 能 很 好 地 
解说 TDD。 
但 问题 是 不 切实 际 。 因 此 我 才 决 定 要 从 零 开 始 开 发 一 个 真实 的 Web 应 用 ， 以 此 为 例 介 
绍 TDD。 这 是 一 个 简单 的 Web 应 用 ， 我 项 望 你 能 把 从 中 学 到 的 知识 运用 到 下 一 个 真 
实 的 项 目 中 。 











这 是 我 们 编写 的 第 一 个 功能 测试 (Functional Test，FT)。 后 面 我 会 深入 说 明 什 么 是 功能 测 
试 ， 以 及 它 和 单元 测试 的 区 别 。 现 在 ， 只 要 能 理解 这 段 代码 做 了 什么 就 行 





























。 启动 一 个 Selenium webdriver， 打 开 一 个 真正 的 Firefox 训 览 器 窗口 ; 
。 在 这 个 浏览 器 中 打开 我 们 期 望 本 地 电脑 伺服 的 网 页 ; 
。 检查 (做 一 个 测试 断言 ) 这 个 网 页 的 标题 中 是 否 包含 单词 “Django”。 





我 们 尝试 运行 一 下 : 


$ python3 functional_tests.py 
Traceback (most recent call last): 
File "functional_tests.py", line 6, in <module> 
assert 'Django' in browser.title 
AssertionError 





你 应 该 会 看 到 弹出 了 一 个 浏览 器 窗口 ， 尝 试 打 开 localhost:8000， 然 后 会 看 到 上 述 Python 
错误 消息 。 接 着 ,会 看 到 Firefox 窗 停留 企 桌 面 上 ， 等 待 你 关闭 。 这 可 能 会 让 你 生气 ， 
我 们 稍 后 会 修正 这 个 问题 。 

















如 果 看 到 关于 导入 Selenium 的 错误 ， 或 许 你 应 该 往 前 翻 ， 看 一 下 “准备 工作 
和 应 具备 的 知识 。 








现在 ， 得 到 了 一 个 失败 测试 。 这 意味 着 ， 我 们 可 以 开始 开发 应 用 了 。 
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1.2 ”让 Django 运行 起 来 
你 肯定 已 经 读 过 “准备 工作 和 应 具备 的 知识 ”了 ， 也 安装 了 Django。 使 用 Django 的 第 一 
步 是 创建 项 目 ， 我 们 的 网 站 就 放 在 这 个 项 目 中 。Django 为 此 提供 了 一 个 命令 行 工具 ， 

















$ django-admin.py startproject superlists 




















文 个 命令 会 创建 一 个 名 为 superlists 的 文件 夹 ， 并 在 其 中 创建 一 些 文件 和 子 文件 夹 : 


| 一 functionaL_tests.py 
-一 superLists 


一 manage.py 
-一 superLists 


一 _init .py 

| 一 settings .py 

一 urLs.py 

-一 wsgi.py 
在 superlists 文件 夹 中 还 有 一 个 名 为 superlists 的 文件 夹 。 这 有 点 让 人 困惑 ， 不 过 确实 
需要 如 此 。 回 顾 Django 的 历史 ， 你 会 找到 出 现 这 种 结构 的 原因 。 现 在 ， 重 要 的 是 知道 
superlists/superlists 文件 夹 的 作用 是 保存 应 用 于 整个 项 目的 文件 ， 例 如 settings.py 的 作用 是 
存储 网 站 的 全 局 配置 信息 。 

















你 还 会 注意 到 manage.py。 这 个 文件 是 Django 的 瑞士 军刀 ， 作 用 之 一 是 运行 开发 服务 器 。 
我 们 来 试 一 下 。 执 行 命令 cd superlists， 进 入 顶层 文件 夹 superlists (我 们 会 经 常 在 这 个 
文件 夹 中 工作 )， 然 后 执行 : 








$ python3 manage.py runserver 
Validating models... 


0 errors found 

Django version 1.7, using settings 'superlists.settings’ 
Development server is running at http://127.0.0.1:8000/ 
Quit the server with CONTROL-C. 


让 这 个 命令 一 直 运行 着 ， 再 打开 一 个 命令 行 窗口 ， 在 其 中 再 次 尝试 运行 测试 (进入 刚刚 打 
开 的 文件 夹 ) : 








$ python3 functional_tests.py 
$ 





我 们 在 命令 行 中 没 执行 多 少 操作 ， 但 你 应 该 注意 两 件 事 : 第 一 ， 没 有 丑陋 的 AssertionError 
了 ; 第 二 ，Selenium 弹出 的 Firefox 窗口 中 显示 的 页 面 不 一 样 了 。 




















这 虽然 看 起 来 设 什 么 大 不 了 ， 但 毕竟 是 我 们 第 一 个 通过 的 测试 啊 ! 值得 庆祝 。 
如 果 感 觉 有 点 神奇 ， 不 太 现 实 ， 为 什么 不 手动 查看 开发 服务 器 ， 打 开 浏 览 器 访问 http:/ 
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localhost:8000 呢 ? 你 会 看 到 如 图 1-2 所 示 的 页 面 














o 











Welcome to Django - Mozilla Firefox EE 
File Edit View History Bookmarks Tools Help 
| Welcome to Django [| 宇 | 
localhost "©| | 图 Goodle Qu 合 rr 


It worked! 
Congratulations on your first Django-powered page. 


Of course, you haven't actually done any work yet. Next, start your first app by running 
python manage.py startapp [appname]. 


You're seeing this message because you have peeuc = True in your Django settings file and 
you haven't configured any URLs. Get to work! 


加 X S99 











图 1-2: Django 可 用 了 
如 果 想 退出 开发 服务 器 ， 可 以 回 到 第 一 个 shell 中 ， 按 Ctrl-C 键 。 


1.3 ”创建 Git 仓 库 





结束 这 章 之 前 ， 还 要 做 一 件 事 : 把 作品 提交 到 版 本 控制 系统 (Version Control System， 
VCS)。 如 果 你 是 一 名 经 验 丰 富 的 程序 员 ， 就 无 需 再 听 我 宣讲 版 本 控制 了 。 如 果 你 刚 接触 
VCS， 请 相信 我 ， 它 是 必 备 工具 。 当 项 目 在 几 周 内 无 法 完成 ， 代 码 越 来 越 多 时 ， 你 需要 一 




















个 工具 查看 旧版 代码 、 撤 销 改动 、 放 心地 试验 新 想法 ， 或 者 只 是 做 个 备份 。 测 试 
和 版 本 控制 关系 紧密 ， 所 以 我 一 定 要 告诉 你 如 何在 开发 流程 中 使 用 版 本 控制 系统 。 











区 动 天 


发 





好 的 ， 来 做 第 一 次 提交 。 如 果 现 在 提交 已 经 晚 了 ， 我 表示 娄 意 。 我 们 使 用 Git 作为 VCS， 


我 们 先 把 functional_tests.py 移 到 superlists 文件 夹 中 。 然 后 执行 git init 命令 ， 创 建仓 库 : 


$ 1s 

superlists functional_tests.py 

$ mv functionaL_tests.py superlists/ 

$ cd superlists 

$ git init . 

Initialised empty Git repository in /workspace/superlists/.git/ 
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从 此 往 后 ， 我 们 会 把 顶层 文件 夹 superlists 作为 工作 目录 。 我 提供 的 输入 命 
令 ， 都 假定 在 这 个 目录 中 执行 。 类 似 地 ， 如 果 我 提 到 一 个 文件 的 路 径 ， 也 
是 相对 于 这 个 顶层 目录 而 言 。 因 此 ，superlists/settings.py 是 指 次 级 文件 来 
superlists 中 的 settings.py。 理 解 了 吗 ? 如 果 有 怀疑 ， 就 查找 manage.py， 你 要 
和 这 个 文件 在 同一 个 目录 中 。 





























现在 ， 添 加 想 提 交 的 文件 一 一 其 实 所 有 文件 都 要 提交 ， 


$ 1s 
db.sqlite3 manage.py superlists functional_tests.py 











db.sqlite3 是 数据 库 文 件 。 不 想 把 这 个 文件 纳入 版 本 控制 ， 因 此 要 将 其 添加 到 一 个 特殊 的 
文件 .gitignore 中 ， 告 诉 Git 将 其 忽略 : 











$ echo "db.sqlite3" >> .gitignore 


接 下 来 ， 我 们 可 以 添加 当前 文件 夹 (“.”) 中 的 其 他 内 容 了 : 


$ git add . 
$ git status 
On branch master 


Initial commit 
Changes to be committed: 
(use "git rm --cached <file>... 


to unstage) 


new file: .gitignore 

new file: functional_ tests.py 
new file: manage.py 

new file: superlists/_ init .py 


new file: superlists/__pycache_ /_ init__.cpython-34.pyc 
new file: superlists/__pycache__/settings.cpython-34.pyc 
new file: superlists/__pycache__/urls.cpython-34.pyc 
new file: superlists/__pycache__/wsgi.cpython-34.pyc 


new file: superlists/settings.py 
new file: superlists/urls.py 
new file: superlists/wsgi.py 








精 灿 ,添加 了 很 多 .pyc 文件 ， 
到 .gitignore 中 : 


这 些 文件 没 必要 提交 。 将 其 从 Git 中 删 掉 ， 并 添加 


下 


$ git rm -r --cached superlists/__pycache _ 

rm 'superlists/_ pycache_ /_ init _.cpython-34.pyc' 
rm 'superlists/_ pycache_ /settings.cpython-34.pyc' 
rm 'superlists/__pycache__/urls.cpython-34.pyc'" 

rm 'superlists/__pycache__/wsgi.cpython-34.pyc'" 

$ echo "__pycache_ " >> .gitignore 

$ echo "*.pyc" >> .gitignore 


现在 ,来 看 一 下 进展 到 哪里 了 (你 会 看 到 ， 我 使 用 git status 的 次 数 太 多 了 ， 所 以 经 常 





使 用 别名 git st。 


看 起 来 不 错 ， 可 以 做 第 


$ git status 
On branch master 


Initial commit 


我 不 会 告诉 你 怎么 做 ， 你 要 自己 探索 Git 别名 的 秘密 ! ) : 


Changes to be committed: 


(use "git rm -- 


new file: 
new file: 
new file: 
new file: 
new file: 
new file: 
new file: 


$ git commit 


cached <file>..." to unstage) 


.gitignore 
functional_tests.py 
manage.py 
superlists/_ init .py 
superlists/settings.py 
superlists/urls.py 
superlists/wsgi.py 

一 次 提交 了 : 














输入 git commit 后 ， 会 弹出 一 个 编辑 器 窗口 ， 让 你 输入 提交 消息 。 我 写 的 消息 如 图 1-3 所 示 。 








COMMIT_EDITM 


File 3 View SR Terminal Help 


# Please en 
# with '#' 
# On branch 


InitiaL < 


1 
2 
3 
4 
5 
6 
7 
8 


= 
四 
四 
二 
be 
# 
i 
其 
# 
# 
# 
二 
一 
be 


(use "9 


new 
new 
new 
new 
new 
new 
new 


.git/COMMIT EDITMSG [+ ]Il| gitcommit 103,0x67 46,1/18 





SG + (/workspace/superlists/.git) - VIM s 


和 the commit message for your changes. Lines starting 
will be ignored, and an empty message aborts the commit. 
master 


(ol 


it rm --cached <file>..." to unstage) 


file: .gitignore 

file: functional_tests.py 
file: manage.py 

file: 

file: 

file: 

file: 








1-3: 首次 Git 提交 














注 1: 





是 不 是 vi 弹出 后 你 不 知道 该 做 什么 ? 或 者 ,你 是 不 是 看 到 了 一 个 消息 ， 内 容 是 关于 账户 识别 的 ， 其 中 


还 显示 了 git config 
些 简单 说 明 。 
































--global user.username ? 再 次 看 一 下 “准备 工作 和 应 具备 的 知识 ”， 里 面 有 一 
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如 果 你 迫切 想 完 成 整个 Git 操作 ， 此 时 还 要 学 习 如 何 把 代码 推送 到 云端 的 VCS 托管 服务 
中 ， 例 如 GitHub 或 BitBucket。 如 果 阅 读本 书 的 过 程 中 使 用 不 同 的 电脑 ， 你 会 发 现 这 么 做 
很 有 用 。 有 具体 的 操作 留 给 你 去 发 掘 ，GitHub 和 BitBucket 的 文档 写 得 都 很 好 。 要 不 ， 你 可 
以 等 到 第 8 章 ， 到 时 我 们 会 使 用 其 中 一 个 服务 做 部 署 。 





对 VCS 的 介绍 结束 。 祝 贺 你 ! 你 使 用 Selenium 编写 了 一 个 功能 测试 ， 安 装 了 Django， 并 
且 使 用 TDD 方式 ， 以 测试 山羊 赞许 的 、 先 写 测 试 这 种 有 保障 的 方式 运行 了 Django。 在 继 
续 阅读 第 2 章 之 前 ， 先 表扬 一 下 自己 吧 ， 这 是 你 应 得 的 奖励 。 
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使 用 unittest 模 块 扩展 功能 测试 





测试 目前 检查 的 是 Django 默认 的 “可 用 了 ”页 面 ， 修 改 一 下 ， 让 其 检查 我 们 想 在 真实 的 
网 站 首页 中 看 到 的 内 容 。 





是 时 候 公 布 我 们 要 开发 什么 类 型 的 Web 应 月 
说 明 我 们 始终 追随 时 尚 ， 很 多 年 前 所 有 的 Web 妹 











地 又 介绍 论坛 和 投票 应 用 ， 现 在 时 兴 的 是 待 办 事项 





明了 一 一 一 个 待 办 事项 清单 网 站 。 开 发 这 种 网 站 
Ff 发 教程 都 介绍 如 何 开发 博客 ， 后 来 一 镶 蜂 





清单 。 


不 过 待 办 事项 清单 是 个 很 好 的 例子 。 很 明显 ， 这 种 应 用 简单 ， 只 显示 一 个 由 文本 字符 串 组 
成 的 列表 ， 因 此 很 容易 得 到 一 个 最 简 可 用 的 应 用 。 


使 用 不 同 的 持久 模型 、 




















而 且 可 以 使 用 各 种 方式 扩展 功能 ， 例 如 





添加 最 后 期 限 、 提 醒 和 分 享 功能 ， 还 可 以 改进 客户 端 UI。 另 外 ， 不 





必 只 局 限于 列 出 待 办 事项 ， 这 种 应 用 可 以 列 出 任何 事项 。 最 重要 的 一 点 是 ， 通 过 这 种 应 


























F 发 过 程 中 的 所 有 主要 步骤 ， 以 及 如 何在 各 个 步骤 中 运用 TDD 理念 。 








2.1 使 用 功能 测试 驱动 开发 一 个 最 简 可 用 的 应 用 


使 用 Selenium 实现 的 测试 可 以 驱动 真正 的 网 页 浏览 器 ， 让 我 们 能 从 用 户 的 角度 查看 应 用 是 


如 何 运 作 的 。 


这 意味 着 ， 功 


故事 ”(User Story) ， 模 拟 用 户 使 用 某 个 功能 的 过 程 ， 以 及 应 用 应 该 如 何 响应 用 户 的 操作 。 


因此 ， 我 们 把 这 类 测试 叫 作 “ 功 能 疯 








i 


能 测试 在 某 种 程度 上 可 以 作为 应 用 的 说 明 书 。 功 能 测试 的 作用 是 跟踪 “用 户 











术语 : 功能 测试 = 验收 测试 = 端 到 端 测试 
我 所 说 的 功能 测试 ， 有 些 人 喜欢 称 之 为 验收 测试 (Acceptance Test) 或 问 到 端 测试 
(End-to-End Test)。 这 类 测试 最 重要 的 作用 是 从 外 部 观察 整个 应 用 是 如 何 运作 的 。 另 
一 个 术语 是 黑箱 测试 (Black Box Test) ， 因 为 这 种 测试 对 所 要 测试 的 系统 内 部 一 无 
所 知 。 























功能 测试 应 该 有 一 个 人 类 可 读 、 容 易 理 解 的 故事 。 为 了 叙事 清楚 ， 可 以 把 测试 代码 和 代码 
注释 结合 起 来 使 用 。 编 写 新 功能 测试 时 ， 可 以 先 写 注释 ， 义 灿 出 用 户 歼 事 的 重点 。 这 样 写 
出 的 测试 人 类 可 读 ， 其 至 可 以 作为 一 种 讨论 应 用 需求 和 功能 的 方式 分 享 给 非 程 序 员 看 。 


TDD 常 与 敏捷 软件 开发 方法 结合 在 一 起 使 用 ， 我 们 经 常 提 到 的 一 个 概念 是 “最 简 可 用 的 应 
用 ”， 即 我 们 能 开发 出 来 的 最 简单 的 而 且 可 以 使 用 的 应 用 。 下 面 我 们 就 来 开发 一 个 最 简 可 
用 的 应 用 ， 尽 早 试 水 。 


最 简 可 用 的 待 办 事项 清单 
这 些 事项 还 在 即 可 。 




































































t 实 只 要 能 让 用 户 输入 一 些 待 办 事项 ， 并 且 用 户 下 次 访问 应 用 时 





NHl 























打开 functional_tests.py， 编 写 一 个 类 似 下 面 的 故事 : 


functional tests.py 
from selenium import webdriver 


browser = webdriver.Firefox() 











# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
browser .get('http://Locathost:8000 ' ) 


























# 她 注意 到 网 页 的 标题 和 头 部 都 包含 "To-Do "这 个 词 


assert 'To-Do' in browser.title 














# 应 用 邀请 她 输入 一 个 待 办 事项 








# 她 在 一 个 文本 框 中 输入 了 "Buy peacock feathers”( 购 买 筷 省 羽毛 
# 伊 迪 丝 的 爱好 是 使 用 假 蝇 做 饵 钓鱼 


# 她 按 回 车 键 后 , 页 面 更 新 了 
# 待 办 事项 表格 中 显示 了 "1: Buy peacock feathers” 
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# 页 面 中 又 显示 了 一 个 文本 框 , 可 以 输入 其 他 的 待 办 事项 
# 她 输入 了 “Use peacock feathers to make a fly”( 使 用 孔雀 羽毛 做 假 蝇 ) 
迪 丝 做 事 很 有 条 理 
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# 页 面 再 次 更 新 ,她 的 清单 中 显示 了 这 两 个 待 办 事项 
# 伊 迪 丝 想 知 道 这 个 网 站 是 否 会 记 住 她 的 清单 





已 
诬 
IN 
攻 


# 她 看 到 网 站 为 她 生成 了 一 个 唯一 的 URL 
# 而 且 页 面 中 有 一 些 文字 解说 这 个 功能 











# 她 访问 那个 URL ,发 现 她 的 待 办 事项 列表 还 在 








# 她 很 满意 ,去 睡觉 了 





browser .quit() 





我 们 有 个 词 来 形容 注释 
我 开始 在 Resolver 工作 时 ， 出 于 善意 习惯 在 代码 中 加 入 密密麻麻 的 详细 注释 。 我 的 同 
事 告 诉 我 :“ 哈 利 ， 我 们 有 个 词 来 形容 注释 ， 我们 把 注释 叫 作 谎言 。 我 很 话剧 : 可 我 
在 学 校 学 到 的 是 ， 注 释 是 好 的 习惯 啊 ? 
他 们 说 得 务 张 了 。 注 释 有 其 作用 ， 可 以 添加 上 下 文 ， 说 明代 码 的 目的 。 他 们 的 意思 是 ， 
简单 重复 代码 意图 的 注释 毫 无 意义 ， 例 如 : 


# 把 wibble 的 值 增加 1 
wibble += 1 


这 样 的 注释 不 仅 之 无 意义 ， 还 有 一 定 危 险 ， 如 果 更 新 代码 后 没有 修改 注释 ,会 误导 别 
人 。 我 们 要 努力 做 到 让 代码 可 读 ， 使 用 有 意义 的 变量 名 和 函数 名 ， 保 持 代码 结构 清晰 ， 
这 样 就 不 再 需要 通过 注释 说 明代 码 做 了 什么 ， 只 要 偶尔 写 一 些 注释 说 明 为 什么 这 么 做 。 


有 些 情况 下 注释 很 重要 。 后 文 会 看 到 ，Django 在 其 生成 的 文件 中 用 到 了 很 多 注释 ， 这 
是 解说 API 的 一 种 方式 。 而 且 还 在 功能 测试 中 使 用 注释 描述 用 户 故事 一 一 把 测试 提炼 
成 一 个 连贯 的 故事 ， 确 保 我 们 始终 从 用 户 的 角度 测试 。 

这 个 领域 中 还 有 很 多 有 趣 的 知识 ， 例 如 行为 驱动 开发 (Behaviour Driven Development) 
和 测试 DSL (Domain Specific Language， 领 域 特定 语言 ) 。 这 些 知识 已 经 超出 本 书 的 范 
畴 了 ， 














你 可 能 已 经 发 现 了 ， 除 了 在 测试 中 加 入 注释 之 外 ， 我 还 修改 了 assert 这 行 代码 ， 让 其 查找 
单词 “To-Do”， 而 不 是 “Django”。 这 意味 着 现在 我 们 期 望 测试 失败 。 运 行 这 个 测试 。 


首先 ， 启动 服务 器 : 











$ python3 manage.py runserver 
然后 在 另 一 个 shell 中 运行 测试 : 


$ python3 functional_tests.py 
Traceback (most recent call last): 
File "functional_tests.py", line 10, in <module> 
assert 'To-Do' in browser.title 
AssertionError 
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这 就 是 预期 失败 。 其 实 失 败 是 好 消息 ， 虽 不 像 测试 通过 那么 令 人 振奋 ， 但 至 少 事 出 有 因 ， 
证 明 测 试 编写 得 正确 。 


2.2 ”Python 标准 库 中 的 unittest 模 块 


上 述 测试 中 有 几 个 恼人 的 问题 需要 处 理 。 首 先 ,“AssertionError” 消 息 没 什么 用 ， 如 果 测 
试 能 指出 在 浏览 器 的 标题 中 到 底 找到 了 什么 就 好 了 。 其 次 ，Firefox 窗口 一 直 停 留 在 桌面 
上 ， 如 果 能 自动 将 其 关闭 就 好 了 。 


解决 第 一 个 问题 ， 可 以 使 用 assert 关键 字 的 第 二 个 参数 ， 写 成 : 




















assert 'To-Do' in browser.title, "Browser title was " + browser.title 


Firefox 窗口 可 在 try/finally 语句 中 关闭 。 但 这 种 问题 在 测试 中 很 常见 ， 标 准 库 中 的 
unittest 模块 已 经 提供 了 现成 的 解决 方法 。 使 用 这 种 方法 吧 ! 在 functional_tests.py 中 写 入 
如 下 代码 : 





functional tests.py 


from selenium import webdriver 
import unittest 


class NewVisitorTest(unittest.TestCase): #0 


def setUp(self): #@ 
self.browser = webdriver.Firefox() 


def tearDown(self): #@ 
self.browser .quit() 


def test can_start a_ list and_retrieve it later(self): #@ 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
seLf .browser .get('http://LocaLhost:8000 ' ) 




















# 她 注意 到 网 页 的 标题 和 头 部 都 包含 “To-Do ”这 个 词 
seLf .assertIn('To-Do' ，seLf.browser .titLe) #@ 
self.fail('Finish the test!') #@ 


# 应 用 邀请 她 输入 一 个 待 办 事项 
Les 其 余 的 注释 和 之 前 一 样 ] 

















if _ name == '_main_': #@ 


unittest.main(warnings='ignore') #@ 
你 可 能 注意 到 以 下 几 个 地 方 了 。 
@ 测试 组 织 成 类 的 形式 ， 继 承 自 unittest.TestCase。 





@ ”测试 的 主要 代码 写 在 名 为 test_can_start_a_list_and_retrieve_it_later 的 方法 中 。 
名 字 以 test_ 开头 的 方法 都 是 测试 方法 ， 由 测试 运行 程序 运行 。 类 中 可 以 定义 多 个 测 


@ @ setUp 和 tearDown 是 特殊 的 方法 ， 











试 方法 。 为 测试 方法 起 个 有 意义 的 名 字 是 个 好 主意 。 


分 别 在 各 个 测试 方法 之 前 和 之 后 和 运行。 我 使 用 这 两 


个 方法 打开 和 关闭 浏览 器 。 注 意 ， 这 两 个 方法 有 点 类 似 try/except 语句 ， 就 算 测 试 中 





出 错 了 ， 也 会 运行 tearDown 方法 。' 测试 结束 后 ，Firefox 窗口 不 会 一 直 停 留 在 桌面 上 了 。 


使 用 self.assertIn 代替 assert 编写 测试 断言 。unittest 提供 了 很 多 这 种 用 于 编写 济 











试 断言 的 辅助 国 数 ， 如 assertEquaL、assertTrue 和 assertFalse 等 。 更 多 断言 辅助 国 


数 参 见 unittest 的 文档 ， 地 址 是 http://docs.python.org/3/library/unittest.html。 





不 管 怎样 ，self.fail 都 会 失败 ， 生 成 指定 的 错误 消息 。 我 使 用 这 个 方法 提醒 测试 结 

















最 后 是 if _name_ == '_main__' 分 句 (如 果 你 之 前 没 见 过 这 种 用 法 ， 我 告 





吉 束 了。 
诉 你 ， 


Python 脚本 使 用 这 个 语句 检查 自 命令 行 中 运行 ， 而 不 是 在 其 他 脚本 中 导入 )。 
我 们 调用 unittest.main() 启动 unittest 的 测试 运行 程序 ， 这 个 程序 会 在 文件 中 自动 














查找 测试 类 和 方法 ， 然 后 运行 。 


warnings='ignore' 的 作用 是 禁止 抛 出 ResourceWarning 异常 。 写 作 本 书 时 这 个 异常 会 抛 











妇 


b= 














来 试 一 下 这 个 测试 。 


$ python3 functional_tests.py 


FAIL: test can_start a list and retrieve it later (_ main _.NewVisitorTest) 
Traceback (most recent call last): 
File "functional_tests.py", line 18, in 
test_can_start a_ list and_retrieve it_ later 
self.assertIn('To-Do', self.browser.title) 
AssertionError: 'To-Do' not found in 'Welcome to Django' 


Ran 1 test in 1.747s 


FAILED (failures=1) 





注 





1: 叭 有 一 个 特例 : 如 果 setup 方法 抛 上 





异常 ， 则 tearDown 方法 不 会 运行 。 





Ls 


出 ， 但 你 阅读 时 我 可 能 已 经 把 这 个 参数 去 掉 了 。 你 可 以 把 这 个 参数 删 掉 ， 看 一 下 效果 。 


有 果 你 阅读 Django 关于 测试 的 文档 ， 可 能 会 看 到 有 个 名 为 LiveServerTestCase 
的 类 ， 而 且 想 知道 我 们 现在 能 否 使 用 。 你 能 阅读 这 份 友好 的 手册 真是 值得 表 
扬 ! 目前 来 说 ，LiveServerTestCase 有 点 复杂 ， 但 我 保证 后 面 的 章节 会 用 到 。 
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这 样 是 不 是 更 好 了 ? 这 个 测试 清理 了 Firefox 窗口 ， 显 示 了 一 个 排版 精美 的 报告 ， 指 出 运 
行 了 几 个 测试 ， 其 中 有 几 个 测试 失败 了 ， 而 且 assertIn 还 显示 了 一 个 有 利于 调试 的 错误 消 
息 。 太 棒 了 ! 


2.3 隐 式 等 待 


现 阶段 还 有 一 件 事 要 做 一 一 在 setup 方法 中 加 入 implicitly_wait. 











functional tests.py 


| We | 

def setUp(self): 
self.browser = webdriver.Firefox() 
self.browser.implicitly_wait(3) 


def tearDown(self): 
[...] 


这 是 Selenium 训 试 中 经 常 使 用 的 方法 。Selenium 在 操作 之 前 等 待 页 面 完 全 加 载 方面 的 表现 
尚 可 ， 但 不 够 完美 。implicitly_wait 的 作用 是 告诉 Selenium， 如 果 需 要 就 等 待 几 秒 钟 。 加 
入 上 述 代 码 后 ， 当 我 们 要 在 页 面 中 查找 内 容 时 ，Selenium 会 等 待 三 秒 钟 ， 让 内 容 出 现 。 


























不 要 依赖 implicitly_wait， 它 并 不 适用 所 有 情况 。 在 简单 的 应 用 中 可 以 使 用 
implicitly_wait， 但 如 第 三 部 分 所 示 (例如 第 15、20 章 )， 当 应 用 超过 某 种 
复杂 度 后 ， 需 要 在 测试 中 编写 更 复杂 的 显 式 等 待 规则 。 























2.4 提交 


现在 是 提交 代码 的 好 时 机 ， 因 为 已 经 做 了 一 次 完整 的 修改 。 我 们 扩展 了 功能 测试 ， 加 入 注 
释 说 明 我 们 要 在 最 简 可 用 的 待 办 事项 清单 应 用 中 执行 哪些 操作 。 我 们 还 使 用 Python 中 的 
unittest 模块 及 其 提供 的 各 种 测试 辅助 函数 重 写 了 测试 。 














执行 git status 命令 ， 你 会 发 现 只 有 functional_tests.py 文件 的 内 容 变 化 了 。 然 后 执行 git 
diff 命令 ， 查 看 上 一 次 提交 和 当前 硬盘 中 保存 内 容 之 间 的 差异 ， 你 会 发 现 functional_tests. 
py 文件 的 变动 很 大 : 


$ git diff 
diff --git a/functional_tests.py b/functional_tests.py 
index d333591. .bo9f22dc 100644 
- a/functional_tests.py 
+++ b/functional_tests.py 
QQ -1,6 +1,45 QQ 
from selenium import webdriver 
+import unittest 
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-browser = webdriver.Firefox() 
-browser .get('http://Llocalhost:8000') 
+CLass NewVisitorTest(unittest.TestCase): 


-assert 'Django' in browser.title 

def setUp(self): 
self.browser = webdriver.Firefox() 
seLf .browser .implicitly_wait(3) 


def tearDown(self): 


宇 
本 
革 
+ self.browser .quit() 
[ 


| 
现在 执行 下 述 命令 : 
$ git commit -a 


-a 的 意思 是 : 自动 添加 已 跟踪 文件 〈 即 已 经 提交 的 各 文件 ) 中 的 改动 。 上 述 命令 不 会 添加 
全 新 的 文件 (你 要 使 用 git add 命令 手动 添加 这 些 文件 )。 不 过 就 像 这 个 例子 一 样 ， 经 常 没 
有 添加 新 文件 ， 因 此 这 是 个 很 有 用 的 简便 用 法 。 


弹出 编辑 器 后 ， 写 入 一 个 描述 性 的 提交 消息 ， 比 如 “使 用 注释 编写 规格 的 首 个 功能 测试 ， 
而 且 使 用 了 unittest”。 














现在 我 们 身 处 一 个 绝妙 的 位 置 ， 可 以 开始 为 这 个 清单 应 用 编写 真正 的 代码 了 。 请 继续 往 下 
阅读 。 














有 用 的 TDD 概念 
。 用 户 故 事 
从 用 户 的 角度 描述 应 用 应 该 如 何 运行 。 用 来 组 织 功 能 测试 。 
。 预期 失败 
意料 之 中 的 失败 。 
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第 3 章 


使 用 单元 测试 测试 简单 的 首页 





上 一 章 结束 时 功能 测试 是 失败 的 ， 失 败 消息 指出 功能 测试 希望 网 站 的 首页 标题 中 包含 “To- 
Do” 这 个 词 。 现 在 要 开始 编写 这 个 应 用 了 。 














警告 ， 要 动 真 格 的 了 
我 故意 把 前 两 章 写 得 这 么 友好 和 简单 。 从 现在 开始 ， 要 真正 编写 代码 了 。 提 前 给 你 打 
个 预防 针 : 有 些 地 方 会 出 错 。 你 看 到 的 结果 可 能 和 我 说 的 不 一 样 。 这 是 好 事 ， 因 为 这 
才 是 广 练 意志 的 学 习 经 历 。 


出 现 这 种 情况 ,一 个 可 能 的 原因 是 ,我 表述 不 清 ， 让 你 误解 了 我 的 本 意 。 你 要 退 一 步 
想 想 要 实现 的 是 什么 ， 在 编辑 哪个 文件 ， 想 让 用 户 做 些 什 么 ， 在 测试 什么 ， 为 什么 要 
测试 ? 有 可 能 你 编辑 了 错误 的 文件 或 函数 ， 或 者 运行 了 其 他 测试 。 我 觉得 停 下 来 想 一 
想 能 更 好 地 学 习 TDD， 比 照搬 所 有 操作 、 复 制 粘 贴 代码 强 得 多 。 

还 有 一 种 原因 ， 可 能 真有 问题 。 认 真 阅读 错误 消息 (阅读 调用 跟踪 的 方法 参见 本 章 
后 面 的 注释 )， 你 会 找到 原因 的 。 可 能 是 漏 掉 了 一 个 过 号 或 未 尾 的 斜 线 ， 或 者 某 个 
Selenium 查找 方法 少 写 了 一 个 “s”。 但 是 , 正如 Zed Shaw 所 说 ， 这 种 调试 也 是 学 习 过 
程 的 重要 组 成 部 分 ， 所 以 一 定 要 坚持 到 底 | 


如 果 你 真 的 卡 住 了 ， 随 时 可 以 给 我 发 电子 邮件 ， 或 者 在 谷歌 小 组 (https://groups.google.com/ 
forum/#!forum/obey-the-testing-goat-book) 中 发 帖 。 祝 你 调试 愉快 ! 











3.1 第 一 个 Django 应 用 ， 第 一 个 单元 测试 

Django 鼓励 以 “应 用 ”的 形式 组 织 代码 ， 这 人 么 做 ， 一 个 项 目 中 可 以 放 多 个 应 用 ， 而 且 可 以 
使 用 其 他 人 开发 的 第 三 方 应 用 ， 也 可 以 重用 自己 在 其 他 项 目 中 开发 的 应 用 。 我 承认 ， 我 自 
己 从 设 真正 这 么 做 过 。 不 过 ， 应 用 的 确 是 组 织 代码 的 好 方法 。 


为 待 办 事项 清单 创建 一 个 应 用 : 


























$ python3 manage.py startapp lists 


这 个 命令 会 在 superlists 文件 夹 中 创建 子 文件 夹 lists， 与 superlists 子 文件 夹 相 邻 ， 并 在 lists 
中 创建 一 些 占 位 文件 ， 用 来 保存 模型 、 视 图 以 及 目前 最 关注 的 测试 : 














superlists/ 

FF” db.sqLite3 

HF functionaL_tests.py 

HF lists 

FF 一 admin.py 

FF 一 init .py 

FF- 一 migrations 
-一 init .py 

FF- 一 models.py 

| 一 tests.py 

-一 views.py 

一 manage.py 

— SuperLists 
FFC _init_ .py 
HF _pycache__ 
FFE settings.py 
FF urls.py 


[一 wsgi.py 


ss sl Lb ~ sl» 
3.2 单元 测 试 及 其 与 功能 测试 的 区 别 
正如 给 事物 所 贴 的 众多 标签 一 样 ， 单 元 测试 和 功能 测试 之 间 的 界线 有 时 不 那么 清晰 。 不 
过 ， 二 者 之 间 有 个 基本 区 别 : 功能 测试 站 在 用 户 的 角度 从 外 部 测试 应 用 ， 单 元 测试 则 站 在 
程序 员 的 角度 从 内 部 测试 应 用 。 














我 遵从 的 TDD 方法 同时 使 用 这 两 种 类 型 测试 应 用 。 采 用 的 工作 流程 大 致 如 下 。 
(1) 先 写 功 能 测试 ， 从 用 户 的 角度 描述 应 用 的 新 功能 。 





(2) 功能 测试 失败 后 ， 想 办 法 编写 代码 让 它 通 过 (或 者 说 至 少 让 当前 失败 的 测试 通过 )。 此 
时 ， 使 用 一 个 或 多 个 单元 测试 定义 希望 代码 实现 的 效果 ， 保 证 为 应 用 中 的 每 一 行 代码 
(至 少 ) 编写 一 个 单元 测试 。 
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(3) 单 元 测试 失败 后 ， 编 写 最 少量 的 应 用 代码 ， 刚 好 让 单元 测试 通过 。 有 时 ， 要 在 第 2 步 和 
第 3 步 之 间 多 次 往复 ， 直 到 我 们 觉得 功能 测试 有 一 点 进展 为 止 。 








(4) 然后 ， 再 次 运行 功能 测试 ， 看 能 否 通过 ， 或 者 有 没有 进展 。 这 一 步 可 能 促使 我 们 编写 一 
些 新 的 单元 测试 和 代码 等 。 

由 此 可 以 看 出 ， 这 整个 过 程 中 ， 功 能 测试 站 在 高 层 驱动 开发 ， 而 单元 测试 则 从 低层 驱动 我 

们 做 些 什么 。 

这 个 过 程 看 起 来 是 不 是 有 点 儿 党 琐 ? 有 时 确实 如 此 ， 但 功能 调试 和 单元 测试 的 目的 不 完全 

一 样 ， 而 且 最 终 写 出 的 测试 代码 往往 区 别 也 很 大 。 

















功能 测试 的 作用 是 帮助 你 开发 具有 所 需 功 能 的 应 用 ， 还 能 保证 你 不 会 无 意 中 
破坏 这 些 功 能 。 单 元 测试 的 作用 是 帮助 你 编写 简洁 无 错 的 代码 。 




















蛙 论 讲 得 够 多 了 ， 下 面 来 看 一 下 如 何 实践 。 


3.3 Django 中 的 单元 测试 
来 看 一 下 如 何 为 首页 视图 编写 单元 测试 。 打 开 新 生成 的 文件 lists/tests.py， 你 会 看 到 类 似 下 
面 的 内 容 : 

















lists/tests.py 


from django.test import TestCase 


# Create your tests here. 


Django 建议 我 们 使 用 TestCase 的 一 个 特殊 版 本 。 这 个 版 本 由 Django 提供 ， 是 标准 版 
unittest.TestCase 的 增强 版 ,添加 了 一 些 Django 专用 的 功能 ， 后 面 几 童 会 介绍 。 

















你 已 经 知道 TDD 循环 要 从 失败 的 测试 开始 ， 然 后 再 编写 代码 让 其 通过 。 但 是 ， 在 此 之 前 ， 
不 管 单元 测试 的 内 容 是 什么 ， 我 们 都 想 知 道 自 动 化 测试 运行 程序 能 否 运行 我 们 编写 的 单元 
测试 。 直 接 运 行 functional_tests.py。 但 Django 生成 的 这 个 文件 有 点 儿 神 奇 ， 所 以 要 确认 一 
下 。 来 故意 编写 一 个 会 失败 的 思春 测试 : 

















lists/tests.py 


from django.test import TestCase 


class SmokeTest(TestCase): 





def test_bad_maths(seLf): 
seLf .assertEquaL(1 + 1 


3 3) 


现在 ， 要 启动 神奇 的 Django 测试 运行 程序 。 和 之 前 一 样 ， 这 也 是 一 个 manage.py 命令 : 





$ python3 manage.py test 


Creating test database for alias 'default'... 


Traceback (most recent call last): 
File "/workspace/superlists/lists/tests.py", line 6, in test_ bad maths 


self.assertEqual(1 + 1, 3) 
AssertionError: 2 != 3 


Ran 1 test in 0.001s 


FAILED (failures=1) 


Destroying test database for alias 'default'... 


太 好 了 ， 看 起 来 能 运行 单元 测试 。 现 在 是 提交 的 好 时 机 : 














$ git status # 会 显示 一 个 消息 ,说 没 跟 踪 Llists/ 


$ git add lists 








$ git diff --staged # 会 显示 将 要 提交 的 内 容 差 异 
$ git commit -m"Add app for lists, with deliberately failing unit test" 





你 猪 得 没 错 ，-m 标志 的 作用 是 让 你 


在 命令 行 中 编写 提交 消息 ， 这 样 就 不 需要 使 用 编辑 器 








了 。 如 何 使 用 Git 命令 行 取决 于 你 自己 ,我 只 是 向 你 展示 我 经 常见 到 的 用 法 。 不 管 使 用 哪 





种 方法 ， 提 交 时 要 遵守 一 个 主要 原由 





:提交 前 一 定 要 审查 想 提 交 的 内 容 。 


3.4 _ Django 中 的 MVC、URL 和 视图 函数 


总 的 来 说 ，Dijango 遵守 了 经 典 的 “模型 - 视图 - 控制 器 ”(Model-View-Controller，MVC ) 


模式 ， 但 并 设 严格 遵守 。Django 确实 有 模型 ， 但 视图 更 像 是 控制 器 ， 模 板 其 实 才 是 视图 。 






































不 过 ，MVC 的 思想 还 在 。 如 果 你 有 兴趣 ， 可 以 看 一 下 Django 常见 问题 解答 (https://docs. 
djangoproject.com/en/1.7/faq/general/) 中 的 详细 说 明 。 


抛 开 这 些 ，Django 和 任何 一 种 Web 





服务 器 一 样 ， 甚 主要 任务 是 决定 用 户 访问 网 站 中 的 某 


个 URL 时 做 些 什么 。Django 的 工作 流程 有 点 儿 类 似 下 述 过 程 : 


(1) 针对 某 个 URL 的 HTTP 请 求 进入 ， 





(2) Django 使 用 一 些 规则 决定 由 哪个 视图 函数 处 理 这 个 请 求 〈 这 一 步 叫 作 解 析 URL) ， 


(3) 选中 的 视图 函数 处 理 请 求 ， 然 后 返回 HTTP 响应 。 
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因此 要 测试 两 件 寻 


。 能 否 解析 网 站 根 路 径 (“/”) 的 URL， 将 其 对 应 到 我 们 编写 的 某 个 视图 函数 上 ? 
。 能 否 让 视图 函数 返回 一 些 HTML， 让 功能 测试 通过 ? 


wl 
































先 编写 第 一 个 测试 。 打 开 lists/tests.py， 把 之 前 编写 的 思春 测试 改 成 如 下 代码 : 


lists/tests.py 


from django.core.urlresolvers import resolve 
from django.test import TestCase 
from lists.views import home_page #@ 


class HomePageTest(TestCase) : 
def test root url_resolves_to home page_view(self): 


found = resolve('/') #@ 
self.assertEqual(found.func, home_page) #@ 


这 段 代 码 是 什么 意思 呢 ? 


@ @ resolve 是 Django 内 部 使 用 的 函数 ， 用 于 解析 URL， 并 将 其 映射 到 相应 的 视图 函数 
上 。 检 查 解 析 网 站 根 路 径 “/” 时 ， 是 否 能 找到 名 为 home_page 的 函数 。 








@ ”这 个 函数 是 什么 ? 这 是 接 下 来 要 定义 的 视图 函数 ， 其 作用 是 返回 所 需 的 HTML。 从 
import 语句 可 以 看 出 ， 要 把 这 个 函数 保存 在 文件 lists/views.py 中 。 























那么 ， 你 觉得 运行 这 个 测试 后 会 有 什么 结果 ? 


$ python3 manage.py test 
ImportError: cannot import name 'home_page' 





个 结果 很 容易 预料 ， 不 过 错误 消息 有 点 无 趣 : A 受 定义 的 国 数 。 但 是 这 对 
TDD 来 说 算是 好 消息 ， 预 料 之 中 的 异常 也 算是 预期 失败 。 现 在 ， 功 能 测试 和 单元 测试 都 失 
败 了 ， 在 测试 山羊 的 庇护 下 ， 我 们 可 以 编写 代码 了 。 


3.5 终于 可 以 编写 一 些 应 用 代码 了 


很 兴奋 吧 ? 但 要 提醒 一 下 : 使 用 TDD 时 要 了 耐 着 性 子 ， 步 步 为 营 。 尤 其 是 学 习 和 起 步 阶段 ， 
一 次 只 能 修改 (或 添加 ) 一 行 代码 。 每 一 次 修改 的 代码 要 尽量 少 ， 让 失败 的 测试 通过 即 可 。 











我 是 故意 这 么 极端 的 。 还 记得 这 个 测试 为 什么 会 失败 吗 ? 因为 我 们 无 法 从 Lists.views 中 
导入 home_page。 很 好 ， 来 修正 这 个 问题 一 一 仅 修正 这 一 个 而 已 。 在 lists/views.py 中 写 入 
下 面 的 代码 : 























lists/views.py 


from django.shortcuts import render 


# 在 这 儿 编 写 视图 


home_page = None 





你 可 能 会 想 :“ 不 是 开玩笑 吧 ? ” 


我 知道 你 会 这 么 想 ， 因 为 我 的 同事 第 一 次 给 我 演示 TDD 时 我 也 是 这 么 想 的 。 耐 心 一 点 ， 
稍 后 会 分 析 这 么 做 是 否 太极 端 。 现 在 ,就算 你 有 点 儿 恼 怒 ， 也 请 跟着 我 一 起 做 ， 看 添加 的 
这 段 代码 有 什么 作用 。 


再 次 运行 测试 : 








$ python3 manage.py test 
Creating test database for alias 'default'... 


Traceback (most recent call last): 
File "/workspace/superlists/lists/tests.py", line 8, in 
test_root_url_resolves_to_home_ page _view 
found = resolve('/') 
File "/usr/local/lib/python3.4/dist-packages/django/core/urlresolvers.py", 
line 485, in resolve 
return get_resolver(urlconf).resolve(path) 
File "/usr/local/lib/python3.4/dist-packages/django/core/urlresolvers.py", 
Line 353, in resolve 
raise Resolver404({'tried': tried, 'path': new_path}) 
django.core.urlresolvers.Resolver404: {'tried': [[<RegexURLResolver 
<RegexURLPattern list> (admin:admin) ^admin/>]], 'path': ''} 


Ran 1 test in 0.002s 


FAILED (errors=1) 
Destroying test database for alias 'default'... 





阅读 调用 跟踪 
点 儿 时 间 讲 解 如 何 阅读 调用 跟踪 ， 因 为 在 TDD 中 经 常 要 做 这 件 事 。 很 快 你 就 能 学 会 
wy 找 出 解决 问题 的 线索 : 


Traceback (most recent call last): 
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File "/workspace/superlists/lists/tests.py", line 8，in 
test_root_url_resolves_to_home_ page_view 
found = resolve('/')@ 


File "/usr/local/\lib/python3.4/dist-packages/django/core/urlresolvers.py", 
line 485, in resolve 


return get_resolver(urlconf).resolve(path) 
File "/usr/local/lib/python3.4/dist-packages/django/core/urlresolvers.py", 
line 353, in resolve 
raise Resolver404({'tried': tried, 'path': new_path}) 
django.core.urlresolvers.Resolver404: {'tried': [[<RegexURLResolver®© 
<RegexURLPattern list> (admin:admin) ^admin/>]], 'path': ''}@ 


@G@ 首先 应 该 查看 错误 本 身 。 有 时 你 只 需 查 看 这 一 处 ， 就 能 立即 找 出 问题 所 在 。 但 某 
些 时 候 ， 比 如 这 个 例子 ， 原 因 就 不 是 那么 明显 。 


@ 接 下 来 要 确认 哪个 测试 失败 了 。 是 刚才 编写 按 预期 会 失败 的 那个 测试 吗 ? 在 这 个 
例子 中 ， 就 是 这 个 测试 。 

@@ 然后 查看 导致 失败 的 测试 代码 。 要 从 调用 跟踪 的 顶部 往 下 看 ， 找 出 错误 发 生 在 
哪个 测试 文件 中 哪个 测试 函数 的 哪 一 行 代 码 。 在 这 个 例子 中 ， 错 误 发 生 在 调用 
resolve 函数 解析 “/” 的 那 一 行 代码 。 

通常 还 有 第 四 步 ， 即 继续 往 下 看 ， 查 找 问 题 牵 涉 的 应 用 代码 。 在 这 个 例子 中 全 是 

Django 的 代码 ， 不 过 在 本 书后 面 的 内 容 中 有 很 多 示例 都 用 到 了 这 一 步 。 


把 以 上 几 步 的 结果 综合 起 来 ， 可 以 解读 出 这 个 调用 跟踪 : 尝试 解析 “/” 时 ，Django 抛 
出 了 404 错误 。 也 就 是 说 ，Django 无 法 找到 “/” 的 URL 映射 。 下 面 来 解决 这 个 问题 。 





3.6 Urls.py 


Django 在 urls.py 文件 中 定义 如 何 把 URL 映射 到 视图 函数 上 。 在 文件 夹 superlists/superlists 
中 有 个 主 urls.py 文件 ， 这 个 文件 应 用 于 整个 网 站 。 看 一 下 其 中 的 内 容 : 


























superlists/urls.py 


from django.conf.urls import patterns, include, url 
from django.contrib import admin 


urlpatterns = patterns('', 
# Examples: 
# url(r'^$', 'superlists.views.home', name='home'), 
# url(r'^blog/', include('blog.urls')), 


url(r'^admin/', include(admin.site.urls)), 








和 之 前 一 样 ， 这 个 文件 中 也 有 很 多 Django 生成 的 辅助 注释 和 默认 建议 。 


url 条 目的 前 半 部 分 是 正则 表达 式 ， 适用 于 哪些 URL。 后 半 部 分 说 明 把 请 求 发 往 何 
处 : 使 用 点 号 表示 的 函数 ， 例 如 ee 或 者 使 用 include 引入 的 另 一 个 
urls.py 文件 。 











下 





可 以 看 到 ， 默 认 情 况 下 有 一 个 用 于 后 台 的 条 目 。 现 在 还 用 不 到 ， 先 将 其 注释 掉 : 





superlists/urls.py 


from django.conf.urls import patterns, include, url 
from django.contrib import admin 


urlpatterns = patterns("' 
# Examples: 
# url(r'^$', 'superlists.views.home', name='home'), 
# url(r'^blog/', include('blog.urls')), 


# url(r'^admin/', include(admin.site.urls)), 


) 


urlpatterns 中 第 一 个 条 目 使 用 的 正则 表达 式 是 傅 ， 表 示 空 字符 串 。 这 和 网 站 的 根 路 径 ， 
即 我 们 要 测试 的 “/” 一样 吗 ? 分 析 一 下 ， 如 果 把 这 行 代码 的 注释 去 掉 会 发 生 什 么 事 呢 ? 





如 果 你 从 未 见 过 正则 表达 式 ， 现 在 相信 我 所 说 的 就 行 。 不 过 你 要 记 在 心 上 ， 
稍 后 去 学 习 如 何 使 用 正则 表达 式 。 








superlists/urls.py 


urlpatterns = patterns('', 
# Examples: 
url(r'^$', 'superlists.views.home', name='home'), 
# url(r'^blog/', include('blog.urls')), 


# url(r'^admin/', include(admin.site.urls)), 











执行 命令 python3 manage.py test， 再 次 运行 测试 : 








ImportError: No module named 'superlists.views' 


La 
django.core.exceptions.ViewDoesNotExist: Could not import 
superlists.views.home. Parent module superlists.views does not exist. 


确实 有 进展 ， 不 再 显示 404 错误 了。 现在 Django 抱怨 点 号 形式 的 views .home 


指向 的 视图 不 存在 。 修 正 这 个 问题 ， 让 它 指 向 占 位 用 的 home_page 对 象 。 这 个 对 象 不 在 
superlists 中 ， 而 在 lists 中 。 
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superlists/urls.py 


urlpatterns = patterns("' 


# Examples: 
url(r'^$', 'lists.views.home page', name='home'), 


然后 再 次 运行 测试 


django.core.exceptions.ViewDoesNotExist: Could not import 
lists.views.home page. View is not callable. 


单元 测试 把 地 址 “/” 和 文件 lists/views.py 中 的 home_page = None 连接 起 来 了 ， 现 在 测试 抱 
怨 home_page 无 法 调用 ， 即 不 是 函数 。 调 整 一 下 ， 把 home_page 从 None 变 成 真正 的 函数 。 


记 住 ， 每 次 改动 代码 都 由 测试 驱使 。 回 到 文件 lists/views.py， 把 内 容 改 成 : 








lists/views.py 


from django.shortcuts import render 











# 在 这 儿 编 写 视图 
def home_page() : 
pass 























现在 测试 的 结果 如 何 ? 


$ python3 manage.py test 
Creating test database for alias 'default'... 


Ran 1 test in 0.003s 


OK 
Destroying test database for alias 'default'... 


太 好 了 ， 第 一 个 测试 终于 通过 了 1! 这 是 一 个 重要 时 刻 ， 我 觉得 值得 提交 一 次 : 


$ git diff # 会 显示 urls.py、tests.py 和 views .py 中 的 变动 
$ git commit -am"First unit test and url mapping, dummy view 


这 是 我 要 介绍 的 最 后 一 种 git commit 用 法 ,把 a 和 nm 标 志 放 在 一 起 使 用 ,意思 是 添加 所 有 
已 跟踪 文件 中 的 改动 ， 而 且 使 用 命令 行 中 输入 的 提交 消息 。 








git commit -am 是 最 快捷 的 方式 ， 但 关于 提交 内 容 的 反馈 信息 最 少 ， 所 以 在 
- 此 之 前 要 先 执行 git status 和 git diff， 漠 清楚 要 把 哪些 改动 放 入 仓库 。 








3.7 为 视图 编写 单元 测试 


该 为 视图 编写 测试 了 。 此 时 ， 不 能 使 用 什么 都 不 做 的 函数 了 ， 我 们 要 定义 一 个 函数 ， 癌 六 
览 器 返回 真正 的 HTML 响应。 打开 lists/tests.py， 添 加 一 个 新 测试 方法 。 我 会 解释 每 一 行 
代码 的 作用 。 














lists/tests.py 


from django.core.urlresolvers import resolve 
from django.test import TestCase 
from django.http import HttpRequest 


from lists.views import home_page 
class HomePageTest(TestCase) : 


def test_root_UrL_resoLves_to_home_page_view(seLf ) : 
found = resolve('/') 
self.assertEqual(found.func, home_page) 


def test home page_returns_correct_html(self): 
request = HttpRequest() #@ 
response = home_page(request) #@ 
self.assertTrue(response.content.startswith(b'<html>')) #@ 
self.assertIn(b'<title>To-Do lists</title>', response.content) #@ 
self.assertTrue(response.content.endswith(b'</html>')) #© 


这 个 新 测试 方法 都 做 了 些 什么 呢 ? 


0 


创建 了 一 个 HttpRequest 对 象 ， 用 户 在 浏览 器 中 请 求 网 页 时 ，Django 看 到 的 就 是 
HttpRequest 对 象 。 














把 这 个 HttpRequest 对 象 传 给 home_page 视图 ， 得 到 响应 。 听 说 响应 对 象 是 HttpResponse 
类 的 实例 时 ， 你 应 该 不 会 觉得 奇怪 。 接 下 来 我 们 断定 响应 的 .content 属性 〈 即 发 送 给 
用 户 的 HTML) 中 有 特定 的 内 容 。 





@ 8 希望 啊 应 以 <html> 标签 开头 ， 并 在 结尾 处 关闭 该 标签 。 注 意 ，response.content 是 原始 


字 节 ， 不 是 Python 字符 串 ， 因 此 对 比 时 要 使 用 b'' 句法。 更 多 信息 参见 Django 文档 中 
“移植 到 Python 3” 部 分 ， 地 址 是 https:/docs.djangoprojectcomyen/ 人 


希望 响应 中 有 一 个 <titte> 标签 ， 其 内 容 包含 单词 “To-Do” 一 一 因为 在 功能 测试 中 
做 了 这 项 测试。 














再 次 说 明 ， 单 元 测试 由 功能 测试 驱动 ， 而 且 更 接近 于 真正 的 代码 。 编 写 单元 测试 时 ， 按 照 
程序 员 的 方式 思考 。 


运行 单元 测试 ， 看 看 进展 如 何 : 





TypeError: home_page() takes 0 positional arguments but 1 was given 
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“单元 测试 /编写 代码 ”循环 


现在 可 以 开始 适应 TDD 中 的 “单元 测试 / 编写 代码 ”循环 了 : 





(1) 在 终端 里 运行 单元 测试 ， 看 它们 是 如 何 失 败 的 ; 








(2) 在 编辑 器 中 改动 最 少量 的 代码 ， 让 当前 失败 的 测试 通过 。 
然后 不 断 重复 。 





想 保证 编写 的 代码 无 误 ， 每 次 改动 的 幅度 就 要 尽量 小 。 这 么 做 才能 确保 每 一 部 分 代码 都 有 
对 应 的 测试 监护 。 乍 看 起 来 工作 量 很 大 ， 但 熟练 后 速度 还 是 很 快 的。 我 们 知道 有 多 快 ， 因 
此 在 工作 中 ， 就 算 确 信 可 以 跳 过 某 一 步 ， 还 是 保证 每 次 只 修改 一 小 部 分 代码 。 





看 一 下 这 个 循环 可 以 运转 多 快 。 
。 小 幅 代 码 改动 : 
lists/views.py 
def home_page(request): 
pass 
。 运行 测试 : 


self.assertTrue(response.content.startswith(b'<html>')) 
AttributeError: 'NoneType' object has no attribute 'content' 


。 编写 代码 一 一 如 你 所 料 ， 使 用 django.http.HttpResponse: 





lists/views.py 
from django.http import HttpResponse 





# 在 这 儿 编 写 视图 
def home_page(request ) : 
return HttpResponse() 














。 再 运行 测试 


self.assertTrue(response.content.startswith(b'<html>')) 
AssertionError: False is not true 





。 再 编写 代码 ， 


lists/views.py 


def home_page(request): 
return HttpResponse('<html>') 





确实 通 
最 后 一 


运行 测试 


运行 测试 : 
AssertionError: b'<title>To-Do lists</title>' not found in b'<html>" 


编写 代码 : 


lists/views.py 


def home_page(request): 
return HttpResponse('<html><title>To-Do lists</title>') 





过 了 吧 ? 


self.assertTrue(response.content.endswith(b'</html>')) 
AssertionError: False is not true 


加 油 ， 最 后 一 击 : 


lists/views.py 


def home_page(request): 
return HttpResponse('<html><title>To-Do lists</title></html>') 


通过 了 吗 ? 


$ python3 manage.py test 
Creating test database for alias 'default'... 


Ran 2 tests in 0.001s 


OK 
Destroying test database for alias 'default'... 


过 了 。 现 在 要 运行 功能 测试 。 如 果 已 经 关闭 了 开发 服务 器 ， 别 忘 了 启动 。 感 觉 这 





次 运行 测试 了 吧 ， 真 是 这 样 吗 ? 


$ python3 functionatL_tests .py 


FAIL: test_can_start_a_List_and_retrieve_it_Later (__ main _.NewVisitorTest) 
Traceback (most recent call last): 
File "functional_tests.py", line 20, in 
test_can_start a_list _and_retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 


Ran 1 test in 1.609s 


FAILED (failures=1) 


日 
这 大 
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失败 了 ， 怎 么 会 ? 哦 ， 原 来 是 那个 提醒 ? 是 吗 ? 是 的 ! 我 们 成 功 编写 了 一 个 网 页 ! 





好 吧 ， 我 觉得 这 样 结束 本 章 很 刺激 。 你 可 能 还 有 点 儿 摸 不 着 头脑 ， 或 许 还 想 知 道 怎么 调整 
这 些 测试 ， 别 担心 ， 后 面 的 章节 会 讲 。 我 只 是 想 在 临近 收尾 的 时 候 让 你 兴奋 一 下 。 

















要 做 一 次 提交 ， 平 复 一 下 心情 ， 再 回想 学 到 了 什么 : 








$ git diff # 会 显示 tests.py 中 的 新 测试 方法 ,以 及 views.py 中 的 视图 
$ git commit -am"Basic view now returns minimal HTML" 














这 一 章 内 容 真 丰富 啊 ! 为 什么 不 执行 git log 命令 回顾 一 下 我 们 取得 的 进展 呢 ? 或 许 还 可 
以 指定 --oneline 标志 : 

$ git log --oneline 

a6e6cc9 Basic view now returns minimal HTML 

450cQOf3 First unit test and url mapping, dummy view 


ea2b037 Add app for lists, with deliberately failing unit test 
[isss] 


不 错 ， 本 章 介 绍 了 以 下 知识 : 


。 新 建 Django 应 用 ， 
。 Django 的 单元 测试 运行 程序 ， 

。 功能 测试 和 单元 测试 之 间 的 区 别 ， 

。 Django 解析 URL 的 方法 ，urls.py 文件 的 作用 ， 
。 Django 的 视图 函数 ， 请 求 和 响应 对 象 ， 

。 如 何 返 回 简单 的 HTML。 




















有 用 的 命令 和 概念 
。 启动 Django 的 开发 服务 器 
python3 manage.py runserver 
。 运行 功能 测试 
python3 functional_tests.py 
。 运行 单元 测试 
python3 manage.py test 
。 “单元 测试 /编写 代码 ” 逢 环 
(在 终端 里 运行 单元 测试 ; 
(2) 在 编辑 器 中 改动 最 少量 的 代码 ; 
(3) 重 复 上 两 步 。 
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编写 这 些 测 咸 有 什么 用 





现在 已 经 实际 演练 了 基本 的 TDD 流程 ， 该 停 下 来 说 说 为 什么 这 么 做 了 。 








我 想象 得 出 很 多 读者 心中 都 积压 了 一 些 挫败 感 ， 某 些 读者 可 能 以 前 写 过 单元 测试 ， 另 一 些 
读者 可 能 只 想 快速 学 会 如 何 测 试 。 你 们 心中 有 些 疑 间 ， 比 如 说 : 





。 编写 的 测试 是 不 是 有 点 儿 多 了 ? 

。 其 中 一 些 测试 肯定 有 重复 吧 ? 功能 测试 和 单元 测试 之 间 有 重复 。 

。 我 的 意思 是 ， 你 为 什么 要 在 单元 测试 中 导入 django.core.urlresolvers 呢 ?” 这 不 是 在 测 
试 作为 第 三 方 代码 的 Django 吗 ? 我 觉得 没 必要 这 么 做 ， 这 么 想 对 吗 ? 

。 单元 测试 有 点 儿 太 琐碎 了 ， 测 试 一 行 声 明代 码 ， 而 且 只 让 函数 返回 一 个 和 常量。 这 么 做 难 
道 不 是 在 浪费 时 间 ? 我 们 是 不 是 应 该 把 时 间 腾 出 来 为 复杂 功能 编写 测试 ? 

。 “单元 测试 / 编写 代码 ”循环 中 的 小 幅 改动 有 必要 吗 ? 我 们 应 该 可 以 直接 跳 到 最 后 一 步 

吧 ? 我 想 说 ，home_page = None ? 真 的 有 必要 吗 ? 

。 难道 现实 中 你 真 这 样 编写 代码 吗 ? 























年 轻 人 啊 ! 以 前 我 也 这 样 满腹 疑问 。 这 些 确实 是 很 好 的 问题 ， 其 实 ， 到 现在 我 也 经 常 问 自 
己 这 些 问 题 。 真 的 值得 做 这 些 事 吗 ? 这 么 做 是 不 是 有 点 儿 宣 目 ? 


4.1 编程 就 像 从 井 里 打 水 


编程 其 实 很 难 ， 我 们 的 成 功 往往 得 益 于 自己 的 聪明 才智 。 假 如 我 们 不 那么 聪明 ，TDD 就 能 
助 我 们 一 臂 之 力 。Kent Beck (TDD 理念 基本 上 就 是 他 发 明 的 ) 打 了 个 比方 。 试 想 你 用 绳子 
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从 井 里 提 一 桶 水 ， 如 采 井 不 太 深 ,而 且 桶 不 是 很 满 ， 提 起 来 很 容易 。 就 算 提 满 满 一 桶 水 ， 刚 


开 
前 

















始 也 很 容易 。 但 要 不 了 多 久 你 就 累 了 。TDD 理念 好 比 是 一 个 环 轮 ， 使 用 它 你 可 以 保存 当 
的 进度 ， 休 息 一 会 儿 ， 而 且 能 保证 进度 绝 不 倒退 。 这 样 你 就 没 必要 一 直 那 么 聪明 了 。 








Test ALLTHE 





Inos 











4-1: 全 部 都 要 测试 


好 吧 ， 或 许 你 基本 上 接受 TDD 是 个 好 主意 ， 但 仍然 认为 我 做 得 太极 端 了 ， 有 必要 测试 得 


这 


测 
间 ， 所 以 目前 你 要 强迫 自己 这 么 做 。 这 就 是 测试 山羊 的 图 片 想 要 表达 的 一 一 对 测试 你 要 顽 





加 


么 细 、 步 子 这 人 么 小 吗 ? 


试 是 一 种 技能 ， 不 是 天 生 就 会 的 。 因 为 很 多 结果 不 会 立刻 显现 ， 需 要 等 待 很 长 一 段 时 








一 用 








细 化 测试 每 个 函数 的 好 处 
就 目前 而 言 ， 测 试 简单 的 函数 和 常量 看 起 来 有 点 傻 。 你 可 能 觉得 不 遵守 这 么 严格 的 规 
则 ， 漏 掉 一 些 单元 测试 ， 应 该 也 算得 上 是 TDD。 但 是 在 这 本 书 中 ， 我 所 演示 的 是 完整 
而 严格 的 TDD 流程 。 像 学 习 武 术 中 的 招式 一 样 ， 在 不 受 影响 的 可 挖 环境 中 才能 让 技能 
变 成 肌肉 记忆 。 现 在 看 起 来 之 所 以 琐碎 ， 是 因为 我 们 刚 开 始 举 的 例子 很 简单 。 程 序 变 
复杂 后 问题 就 来 了 ， 到 时 你 就 知道 测试 的 重要 性 了 。 你 要 面临 的 危险 是 ， 复 杂 性 逐 沿 
靠近 ， 而 你 可 能 没 发 觉 ， 但 不 久之 后 你 就 会 变 成 温水 都 青 星 。 
我 赞成 为 简单 的 函数 编写 细 化 的 简单 测试 ， 关 于 这 一 观点 我 还 有 这 么 两 点 要 说 。 
首先 ， 既 然 测 试 那么 简单 ， 写 起 来 就 不 会 花 很 长 时 间 。 所 以 ， 别 抱 扰 了 ， 只 管 写 就 
是 了 。 
其 次 ， 占 位 测试 很 重要 。 先 为 简单 的 函数 写 好 测试 ， 当 函数 变 复杂 后 ， 这 道 心理 障碍 
就 容易 迈 过 去 。 你 可 能 会 在 函数 中 添加 一 个 if 语 向 ， 几 周 后 再 添加 一 个 for 循环 ， 不 
知 不 觉 间 就 将 其 变 成 一 个 基于 元 类 (meta-class) 的 多 态 树 状 结构 解析 器 了 。 因 为 从 一 


五 








注 1: 原画 出 自 Allie Brosh 的 网 站 Hyperbole and a Half (http://hyperboleandahalf.blogspot.co.uk/2010/06/this-is- 





why-ill-never-be-adulthtml) 。 译 者 注 
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开始 你 就 编写 了 测试 ， 每 次 修改 都 会 自然 而 然 地 添加 新 测试 ， 最 终 得 到 的 是 一 个 测试 
良好 的 函数 。 相 反 ， 如 果 你 试图 判断 函数 什么 时 候 才 复杂 到 需要 编写 测试 的 话 ， 那 就 
太 主 观 了 ， 而且 情况 会 变 得 更 粳 ， 因 为 没有 占 位 测试 ， 此 时 开始 编写 测试 需要 投入 很 
多 精力 ， 每 次 改动 代码 都 冒 着 风险 ， 你 开始 拖延， 很 快 青蛙 就 者 熟 了 。 

不 要 试图 找 一 些 不 靠 谱 的 主观 规则 ， 去 判断 什么 时 候 应 该 编写 测试 ， 什 么 时 候 可 以 全 
身 而 退 。 我 建议 你 现在 遵守 我 制定 的 训练 方法 ， 因 为 所 有 技能 都 一 样 ， 只 有 花 时 间 学 
会 了 规则 才能 打破 规则 。 








接 下 来 继续 实践 
4.2 ”使 用 Selenium 测试 用 户 交 互 


前 一 章 结 束 时 进展 到 哪里 了 ? 重新 运行 测试 找 出 答案 : 


$ python3 functional_tests.py 
F 


FAIL: test can_start a list and retrieve it later (_ main _.NewVisitorTest) 


Traceback (most recent call last): 
File "functional_tests.py", line 20, in 
test_can_start a list and _ retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 


Ran 1 test in 1.609s 


FAILED (failures=1) 





你 运行 了 吗 ? 是 不 是 看 到 一 个 错误 ， 说 “加 载 页 面 出 错 ” 或 者 “无 法 连接 ”? 我 也 看 到 
了 。 这 是 因为 运行 测试 之 前 没有 使 用 manage.py runserver 启动 开发 服务 器 。 运 行 这 个 命 
令 ， 然 后 你 会 看 到 我 们 期 待 的 那个 失败 消息 





全 


TDD 的 优点 之 一 是 ， 永 远 不 会 忘记 接 下 该 做 什么 一 一 重新 运行 测试 就 知道 要 
做 的 事 了 。 





失败 消息 说 “Finish the test” (结束 这 个 测试 )， 那 么 ， 就 来 结束 它 吧 ! 打开 functional_tests.py 
文件 ,扩充 其 中 的 功能 测试 
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functional tests.py 
from selenium import webdriver 


from selenium.webdriver.common.keys import Keys 
import unittest 


class NewVisitorTest(unittest.TestCase): 


def setUp(self): 
self.browser = webdriver.Firefox() 
seLf .browser .implicitly_wait(3) 


def tearDown(self): 
self.browser .quit() 


def test can_start a_ list and_retrieve it later(self): 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
seLf .browser .get('http://LocaLhost:8000 ' ) 


























# 她 注意 到 网 页 的 标题 和 头 部 都 包含 "To-Do ”这 个 词 
self.assertIn('To-Do', self.browser.title) 

header_text = self.browser.find_ element_by_tag_name('h1').text 
self.assertIn('To-Do', header_text) 


# 应 用 邀请 她 输入 一 个 待 办 事项 
inputbox = self.browser.find element_ by_id('id new item') 
self.assertEqual( 

inputbox.get_attribute('placeholder'), 

'Enter a to-do item' 


# 她 在 一 个 文本 框 中 输入 了 “Buy peacock feathers”( 购 买 扎 省 羽毛 ) 
# 伊 迪 丝 的 爱好 是 使 用 假 蝇 做 鱼饵 钓鱼 


inputbox.send_keys('Buy peacock feathers ' ) 




















# 她 按 回 车 键 后 ,页 面 更 新 了 
# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers” 
inputbox.send_keys(Keys .ENTER) 











table = self.browser.find element by _ id('id list table') 
rows = table.find elements_by_tag_name('tr') 
seLf .assertTrue( 
any(row.text == '1: Buy peacock feathers' for row in rows) 


) 


# 页 面 中 又 显示 了 一 个 文本 框 ,可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use peacock feathers to make a fly”( 使 用 孔雀 羽毛 做 假 晶 ) 
# 伊 迪 丝 做 事 很 有 条 理 
self.fail('Finish the test!') 






































# 页 面 再 次 更 新 ,她 的 清单 中 显示 了 这 两 个 待 办 事项 
[a 

















我 们 使 用 了 Selenium 提供 的 几 个 用 来 查找 网 页 内 容 的 方法 : find_element_by_tag_name， 





find_eLement_by id 和 find_elements_by_tag_name (注意 有 个 s， 也 就 是 说 这 个 方法 会 返回 
多 个 元 素 )。 还 使 用 了 send_keys， 这 是 Selenium 在 输入 框 中 输入 内 容 的 方法 。 你 还 会 看 到 使 
用 了 Keys 类 ( 别 忘 了 导入 )， 它 的 作用 是 发 送 回 车 键 等 特殊 的 按键 ， 还 有 Ctrl 等 修改 键 。 








小 心 Selenium 中 find_element_by... 和 find_elements_by... 这 两 类 国 
数 的 区 别 。 前 者 返回 一 个 元 素 ， 如 果 找 不 到 就 抛 出 异常 ， 后 者 返回 一 个 列 
表 ， 这 个 列表 可 能 为 空 。 

















还 有 ， 留 意 一 下 any 国 数 ， 它 是 Python 中 的 原生 函数 ， 却 鲜 为 人 知 。 不 用 我 解释 这 个 函数 
的 作用 了 吧 ? 使 用 Python 编程 就 是 这 么 民 意 。 








不 过 ， 如 果 你 不 懂 Python 的 话 ， 我 告诉 你 ，any 函数 的 参数 是 个 生成 器 表达 式 (generator 
expression) ， 类 似 于 列表 推导 (list comprehension) ， 但 比 它 更 为 出 色 。 你 需要 仔细 研究 这 
个 概念 。 能 搜 到 Guido 对 这 一 概念 的 精彩 解释 (http://python-history.blogspot.co.uk/2010/06/ 
from-list-comprehensions-to-generator.html) 。 读 完 之 后 你 就 会 知道 ， 这 个 图 数 可 不 仅仅 是 为 
了 让 编程 民 意 。 





看 一 下 测试 进展 如 何 : 


$ python3 functional_tests.py 

Las] 

selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"tag name","selector":"h1i"}' ; Stacktrace: [...] 














解释 一 下 ， 测 试 报错 在 页 面 中 找 不 到 <h1> 元 素 。 看 一 下 如 何在 首页 的 HTML 中 加 入 这 个 
元 素 。 

大 幅 修改 功能 测试 后 往往 有 必要 提交 一 次 。 初 稿 中 我 没 这 么 做 ， 想 通 之 后 就 后 悔 了 ， 可 是 
已 经 和 其 他 代码 混在 一 起 提交 了 。 其 实 提交 得 越 频 繁 越 好 : 


























$ git diff # 会 显示 对 functional_tests.py 的 改动 
$ git commit -am "Functional test now checks we can input a to-do item" 


4.3 ”遵守 “不 测试 常量 ”规则 ， 使 用 模板 解决 这 
个 问题 
看 一 下 lists/tests.py 中 的 单元 测试 。 现 在 ， 要 查找 特定 的 HTML 字符 串 ， 但 这 不 是 测试 


HTML 的 高 效 方法 。 一 般 来 说 ， 单 元 测试 的 规则 之 一 是 “不 测试 常量 *。 以 文本 形式 测试 
HTML 很 大 程度 上 就 是 测试 常量 。 


换 名 话说 ， 如 果 有 如 下 的 代码 : 
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wibble = 3 
在 测试 中 就 不 大 有 必要 这 么 写 : 


from myprogram import wibble 
assert wibble == 3 





单元 测试 要 测试 的 其 实 是 逻辑 、 流 程控 制 和 配置 。 编 写 断 言 检 测 HIML 字符 串 中 是 否 有 指 
定 的 字符 序列 ， 不 是 单元 测试 应 该 做 的 。 














而 且 ， 在 Python 代码 中 插入 原始 字符 串 真 的 不 是 处 理 HTML 的 正确 方式 。 我 们 有 更 好 
的 方法 ， 那 就 是 使 用 模板 。 如 果 把 HTML 放 在 一 个 扩展 名 为 .html 的 文件 中 ， 先 不 说 其 
他 好 处 ， 单 就 得 到 更 好 的 名 法 高 亮 支持 这 一 点 而 言 也 值 了 。Python 领域 有 很 多 模板 框架 ， 
Django 有 自己 的 模板 系统 ， 而 且 很 好 用 。 来 使 用 这 个 模板 系统 吧 。 


使 用 模板 重 构 
现在 要 做 的 是 让 视图 函数 返回 完全 一 样 的 HTML， 但 使 用 不 同 的 处 理 方式 。 这 个 过 程 叫 作 
重 构 ， 即 在 功能 不 变 的 前 提 下 改进 代码 。 


功能 不 变 是 最 重要 的 。 如 果 重 构 时 添加 了 新 功能 ， 很 可 能 会 产生 问题 。 重 构 本 身 也 是 一 门 
学 问 ， 有 专门 的 参考 书 一 一 Martin Fowler 写 的 《 重 构 》 (http://refactoring.com/)。 























重 构 的 首要 原则 古 不 能 没有 测试 。 幸 好 我 们 在 做 测试 驱动 开发 ， 测 试 已 经 有 了 。 检 查 一 下 
测试 能 否 通过 ， 测 试 能 通过 才能 保证 重 构 前 后 的 表现 一 直 : 
$ python3 manage.py test 


[...] 
OK 








很 好 ! 先 把 HTML 字符 串 提 取出 来 写 入 单独 的 文件 。 新 建 用 于 保存 模板 的 文件 夹 lists/ 
templates， 然 后 新 建文 件 lists/templates/home.html， 再 把 HTML 写 入 这 个 文件 ?。 





lists/templates/home.html 
<html> 
<title>To-Do lists</title> 
</html> 





高 亮 显 示 的 句法 ， 漂 亮 多 了 ! 接 下 来 修改 视图 





区 
洋 











注 2， 有 些 人 喜欢 使 用 和 应 用 同名 的 子 文件 夹 〈 即 lists/templates/lists)， 然 后 使 用 lists/home.html 引用 这 个 模 
板 ， 这 叫 作 “模板 命名 空间 ”。 我 觉得 对 小 型 项 目 来 说 使 用 模板 命名 空间 太 复 杂 了 ， 不 过 在 大 型 项 目 
中 可 能 有 用 武之 地 。 详 情 参 阅 Django 教程 (https://docs.djangoproject.com/en/1.7/intro/tutorial03/#write- 


views-that-actually-do-something ) 。 
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lists/views.py 


from django.shortcuts import render 


def home_page(request): 
return render(request, 'home.html') 


现在 不 自己 构建 HttpResponse 对 象 了 ， 转 而 使 用 Django 中 的 render 函数 。 这 个 函数 的 第 
一 个 参数 是 请 求 对 象 的 ， 第 二 个 参数 是 渲染 的 模板 名 。Django 会 自动 在 所 有 的 应 用 目录 中 
搜索 名 为 templates 的 文件 来， 然后 根据 模板 中 的 内 容 构建 一 个 HttpResponse 对 象 。 





模板 是 Django 中 一 个 很 强大 的 功能 ， 使 用 模板 的 主要 优势 之 一 是 能 把 
Python 变量 代入 HTML 文本 。 现 在 还 没 用 到 这 个 功能 ， 不 过 后 面 的 章节 会 
用 到 。 这 就 是 为 什么 使 用 render 和 render_to_string ( 稍 后 用 到 )， 而 不 用 
原生 的 open 函数 手动 从 硬盘 中 读 取 模板 文件 的 缘故 。 





看 一 下 模板 是 否 起 作用 了 : 


$ python3 manage.py test 
[ee] 


Traceback (most recent call last): 
File "/workspace/superlists/lists/tests.py", line 17, in 
test_home_page_returns_correct_html 
response = home_page(request)@ 
File "/workspace/superlists/lists/views.py", line 5, in home_page 
return render(request, 'honme.html')®© 
File "/usr/local/lib/python3.3/dist-packages/django/shortcuts.py", line 48, in 
render 
return HttpResponse(loader.render_to_string(*args, **kwargs), 
File "/usr/local/lib/python3.3/dist-packages/django/template/loader .py", line 
170, in render_to_string 
t = get_ template(template name, dirs) 
File "/usr/local/lib/python3.3/dist-packages/django/template/loader .py", line 
144, in get_ template 
template, origin = find_template(template name, dirs) 
File "/usr/local/lib/python3.3/dist-packages/django/template/loader .py", line 
136, in find_template 
raise TemplateDoesNotExist(name) 
django. template.base.TemplateDoesNotExist: honme.html@ 


Ran 2 tests in 0.004s 
又 遇 到 一 次 分 析 调用 跟踪 的 机 会 。 
@ 先 看 错误 是 什么 : 测试 无 法 找到 模板 。 
@ 然后 确认 是 哪个 测试 失败 : 很 显然 是 测试 视图 HTML 的 测试 。 
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@ 然后 找到 导致 失败 的 是 测试 中 的 哪 一 行 : 调用 home_page 函数 那 行 。 

@ 最 后 ， 在 应 用 的 代码 中 找到 导致 失败 的 部 分 : 调用 render 函数 那 段 。 

那 为 什么 Django 找 不 到 模板 呢 ? 模板 在 lists/templates 文件 夹 中 ， 它 就 该 放 在 这 个 位 置 啊 。 
原因 是 还 没有 正式 在 Django 中 注册 lists 应 用 。 执 行 startapp 命令 以 及 在 项 目 文件 夹 中 
存放 一 个 应 用 还 不 够 ， 你 要 告诉 Django 确实 要 开发 一 个 应 用 ， 并 把 这 个 应 用 添加 到 文件 


settings.py 中 。 这 么 做 才能 保证 万 无 一 失 。 打 开 settings.py， 找 到 变量 INSTALLED_APPS， 把 
Lists 加 进去 : 





superlists/settings.py 


# Application definition 


INSTALLED_APPS = ( 
'django.contrib.admin', 
'django.contrib.auth', 
"django.contrib.contenttypes ' ， 
"django.contrib.sessions ' ， 
"django.contrib.messages ' ， 
'django.contrib.staticfiles', 
'lists', 


) 


可 以 看 出 ， 默 认 已 经 有 很 多 应 用 了 。 只 需 把 Lists 加 到 列表 的 末尾 。 别 忘 了 在 行 尾 加 上 喜 
号 ， 这么 做 虽然 不 是 必须 的 ， 但 如 果 忘 了 ，Python 会 把 不 在 同一 行 的 两 个 字符 串 连 起 来 ， 
到 时 你 就 傻眼 了 。 


现在 可 以 再 运行 测试 看 看 : 























$ python3 manage.py test 
[...] 


self.assertTrue(response.content.endswith(b'</html>')) 
AssertionError: False is not true 


你 能 否 看 到 这 个 错误 取决 于 你 使 用 的 文本 编辑 器 是 否 会 在 文件 的 最 后 添加 一 
个 空 行 。 如 果 没 看 到 ， 你 可 以 跳 过 下 面 儿 段 ， 直 接 跳 到 测试 通过 那 部 分 。 


不 过 确实 有 进展 。 看 起 来 测试 找到 模板 了 ， 但 最 后 三 个 断言 失败 了 。 很 显然 输出 的 末尾 出 
了 问题 。 我 使 用 print repr(response.content) 调试 这 个 问题 ， 发 现 是 因为 转 用 模板 后 在 
响应 的 末尾 引入 了 一 个 额外 的 空 行 (\n)。 按 下 面 的 方式 修改 可 以 让 测试 通过 : 











lists/tests.py 


self.assertTrue(response.content.strip().endswith(b'</html>')) 
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这 么 做 有 点 像 作弊 ， 不 过 HIML 文件 末尾 的 空白 并 不 重要 。 再 运行 测试 看 看 : 


$ python3 manage.py test 
FE 


OK 
对 代码 的 重 构 结束 了 ， 测 试 也 证 实 了 重 构 前 后 的 表现 一 臻 。 现 在 可 以 修改 测试 ， 不 再 测试 
常量 ， 检 查 是 否 泻 染 了 正确 的 模板 。Django 中 的 另 一 个 辅助 函数 render_to_string 可 以 给 
些 帮助 


lists/tests.py 


from django.tempLate.Loader import render_to_string 


def test home page_returns_correct_html(self): 
request = HttpRequest() 
response = home_page(request) 
expected_html = render_to_string('home.html') 
self.assertEqual(response.content.decode(), expected_html) 


使 用 .decode() 把 response.content 中 的 字 节 转换 成 Python 中 的 Unicode 字符 串 ， 这 样 就 
可 以 对 比 字 符 串 ， 而 不 用 像 之 前 那样 对 比 字 节 。 











这 次 重 构想 表达 的 重点 是 ， 不 要 测试 常量 ， 应 该 测试 实现 的 方式 。 做 得 好 ! 














Django 提供 了 一 个 测试 客户 端 ， 其 中 有 用 于 测试 模板 的 工具 。 后 面 的 章节 会 
用 到 这 个 测试 客户 端 。 现 在 使 用 的 是 低层 工具 ， 目 的 是 让 你 和 弄 明白 其 中 的 工 
作 方 式 。 可 以 看 出 ， 并 不 神奇 。 


























4.4 关于 重 构 


这 个 重 构 的 例子 很 繁琐 。 但 正如 Kent Beck 在 Test-Driven Development: By Example 一 书 中 
所 说 的 :“ 我 是 推荐 你 在 实际 工作 中 这 么 做 吗 ? 不 是 。 只 是 建议 你 要 知道 怎么 按照 这 种 方 
式 做 。 


其 实 ， 写 这 一 部 分 时 我 的 第 一 反应 是 先 修改 代码 ， 直 接 使 用 render_to_string 国 数 ， 删 
除 那 三 个 多 余 的 断言 ， 只 在 泻 染 得 到 的 结果 中 检查 期 望 看 到 的 内 容 ， 然 后 再 修改 代码 。 但 
要 注意 ， 如 果真 这 么 做 了 可 能 就 会 犯错 ， 因 为 我 可 能 不 会 在 模板 中 编写 正确 的 <htmtl> 和 
<title> 标签 ， 而 是 随便 写 一 些 字 符 串 。 








重 构 时 ， 修 改 代码 或 者 测试 ， 但 不 能 同时 修改 。 
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在 重 构 的 过 程 中 总 有 超前 几 步 的 冲动 ， 想 对 应 用 的 功能 做 些 改动 ， 不 入， 修改 的 文件 就 会 
变 得 越 来 越 多 ， 最 终 你 会 忘记 自己 秧 在 何 处 ， 而 且 一 切 都 无 法 正常 运行 了 。 如 果 你 不 想 让 
自己 变 成 “ 重 构 猫 ”( 如 图 4-2) ， 迈 的 步子 就 要 小 一 点 ， 把 重 构 和 功能 调整 完全 分 开 来 做 。 











Codejreiactoring 


4-2: 重 构 猫 一 一 记得 要 看 完整 的 动态 GIF 图 (来 源 : 4GIFs.com) 








后 面 会 再 次 遇 到 重 构 猫 ， 用 来 说 明 头 脑 发 热 、 一 次 修改 很 多 内 容 带 来 的 后 
果 。 你 可 以 把 这 只 猫 想 象 成 卡通 片 中 浮现 在 另 一 个 肩膀 上 的 魔鬼 ， 它 和 测试 
山羊 的 观点 是 对 立 的 ， 总 给 些 不 好 的 建议 。 


重 构 后 最 好 做 一 次 提交 : 
$ git status # 会 看 到 tests.py,views.py,settings.py, 以 及 新 建 的 templates 文 件 夹 
$ git add . # 还 会 添加 尚未 跟踪 的 templates 文 件 夹 


$ git diff --staged # 审查 我 们 想 提交 的 内 容 
$ git commit -m"Refactor home page view to use a template" 


4.5 接着 修改 首页 


现在 功能 测试 还 是 失败 的 。 修 改 代 码 ， 让 它 通 过 。 因 为 HTML 现在 保存 在 模板 中 ， 可 以 尽 
情 修 改 ， 无 需 编写 额外 的 单元 测试 。 我 们 需要 一 个 <h1> 元 素 : 




















lists/templates/home.html 
<html> 
<head> 
<title>To-Do lists</title> 
</head> 
<body> 
<h1>Your To-Do List</h1> 
</body> 
</htmL> 


看 一 下 功能 测试 是 否认 同 这 次 修改 : 





selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id new item"}' ; Stacktrace: [...] 


不 错 ， 继 续 修改 : 


lists/templates/home.html 


Es: 
<h1>Your To-Do List</h1> 
<input id="id new_item" /> 
</body> 
| 


现在 呢 ? 
AssertionError: '' != 'Enter a to-do item' 
加 上 占 位 文字 : 


lists/templates/home.html 


<input id="id new item" placeholder="Enter a to-do item" /> 
得 到 了 下 述 错误 : 


selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id list table"}' ; Stacktrace: [...] 


因此 要 在 页 面 中 加 入 表格 。 目 前 表格 是 空 的 : 


lists/templates/home.html 


<input id="id new_item" placeholder="Enter a to-do item" /> 
<table id="id_list_table"> 
</table> 

</body> 


现在 功能 测试 的 结果 如 何 ? 


File "functional_tests.py", line 42, in 
test_can_start a list _and_retrieve it later 
any(row.text == '1: Buy peacock feathers' for row in rows) 
AssertionError: False is not true 


有 点 儿 临 淮 。 可 以 使 用 行 号 找 出 问题 所 在 ， 原 来 是 前 面 我 沾沾自喜 的 那个 any 函数 导致 
的 ， 或 者 更 准确 地 说 是 assertTrue， 因 为 没有 提供 给 它 明确 的 失败 消息 。 可 以 把 自 定义 的 
错误 消息 传 给 unittest 中 的 大 多 数 assertX 方法 : 




















functional tests.py 


seLf .assertTrue( 
any(row.text == '1: Buy peacock feathers' for row in rows), 
"New to-do item did not appear in table" 


) 
再 次 运行 功能 测试 ， 应 该 会 看 到 我 们 编写 的 消息 : 
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AssertionError: False is not true : New to-do item did not appear in table 
不 过 现在 如 果 想 让 测试 通过 ， 就 要 真正 处 理 用 户 提交 的 表单 ， 但 这 是 下 一 章 的 话题 。 
现在 做 个 提交 吧 : 


$ git diff 
$ git commit -am"Front page HTML now generated from a template" 


多 亏 这 次 重 构 ， 视 图 能 演 染 模板 了 ， 也 不 再 测试 常量 了 ， 现 在 准备 好 处 理 用 户 的 输入 了 。 
4.6 ” 总结: TDD 流程 

至 此 ， 我 们 已 经 在 实践 中 见识 了 TDD 流程 中 涉及 的 所 有 主要 概念 : 

。 功能 测试 ， 


















































。 单元 测试 
。 “单元 测试 /编写 代码 ”循环 ， 
。 重 构 。 








现在 要 稍微 总 结 一 下 ， 或 许可 以 画 个 流程 图 。 请 原谅 我 ， 做 了 这 么 多 年 管理 顾问 ， 养 成 了 
这 个 习惯 。 不 过 流程 图 也 有 好 的 一 面 ， 能 清楚 地 表明 流程 中 的 循环 。 


TDD 的 总 体 流 程 是 什么 呢 ? 参见 图 4-3。 
































编写 测试 运行 测试 。 是 否 需 要 重 构 ? 


是 否 通过 ? 











4-3: TDD 的 总 体 流程 








首先 编写 一 个 测试 ， 运 行 这 个 测试 看 着 它 失 败 。 然 后 编写 最 少量 的 代码 取得 一 些 进 展 ， 再 
运行 测试 。 如 此 不 断 重 复 ， 直 到 测试 通过 为 止 。 最 后 ， 或 许 还 要 重 构 代 码 ， 测 试 能 确保 不 
破坏 任何 功能 。 























可 是 ， 如 果 既 有 功能 测试 又 有 单元 测试 应 该 怎么 运用 这 个 流程 呢 ?” 你 可 以 把 功能 测试 当 作 
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循环 的 一 种 高 层 视 角 ,“ 编 写 代 码 让 功能 测试 通过 ”这 一 步 涉及 另 一 个 小 型 TDD 循环 ， 这 
个 小 循环 使 用 单元 测试 。 如 图 4-4 所 示 。 














让 运行 功能 测试 。 


应 用 是 否 


元 测试 测试 需要 重 构 ? 








“单元 测试 /编写 代码 ”循环 

















图 4-4: 包含 功能 测试 和 单元 测试 的 TDD 流程 





编写 一 个 功能 测试 ， 看 着 它 失 败 。 接 下 来 ,，“ 编 写 代码 让 它 通过 ”这 一 步 是 一 个 小 型 TDD 
循环 : 编写 一 个 或 多 个 单元 测试 ， 然 后 进入 “单元 测试 /编写 代码 ”循环 ， 直 到 单元 测试 
通过 为 止 。 然 后 回 到 功能 测试 ， 查 看 是 否 有 进展 ， 这 一 步 还 可 以 多 编写 一 些 应 用 代码 ， 再 
编写 更 多 的 单元 测试 ， 如 此 一 直 循环 下 去 。 























牵涉 到 功能 测试 时 应 该 怎么 重 构 呢 ? 要 使 用 功能 测试 检查 重 构 前 后 的 表现 是 否 一 致 。 不 
过 ， 可 以 修改 、 添 加 或 删除 单元 测试 ， 或 者 使 用 单元 测试 循环 修改 实现 方式 。 








功能 测试 是 应 用 是 否 能 正常 运行 的 最 终 评判 。 单 元 测试 只 是 整个 开发 过 程 中 的 一 个 辅助 工具 。 














这 种 看 待 事物 的 方式 有 时 叫 作 “ 双 循 环 测 试 驱动 开发 ”。 本 书 的 优秀 技术 审查 之 一 Emily 
Bache 写 了 一 篇 博客 文章 ， 从 不 同 的 视角 讨论 了 这 个 话题 ， 推 荐 你 阅读 ， 地 址 是 http:// 
coding-is-like-cooking.info/2013/04/outside-in-development-with-double-loop-tdd/。 
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在 接 下 来 的 章节 中 会 更 深入 地 探索 这 个 工作 流程 中 的 各 个 组 成 部 分 。 








如 何 检查 你 的 代码 ， 以 及 在 必要 时 跳 着 阅读 


书 中 使 用 的 所 有 代码 示例 都 可 以 到 我 放 在 GitHub 中 的 仓库 (https://github.com/hjwp/book- 
example/) 中 获取 。 因 此 ， 如 果 你 想 拿 自己 的 代码 和 我 的 比较 ， 可 以 到 这 个 仓库 中 看 一 下 。 


每 一 章 的 代码 都 放 在 单独 的 分 支 中 ， 分 支 名 统一 使 用 chapter_XX 形式 ， 例 如 : 

。 第 3 章 : https://github.com/hjwp/book-example/tree/chapter_03; 

。 第 4 章 : https://github.com/hjwp/book-example/tree/chapter_04; 

。 第 5 章 : https://github.com/hjwp/book-example/tree/chapter_05。 

。 以 此 类 推 。 

注意 ， 各 分 支 包 含 对 应 章节 中 的 全 部 提交 ， 因 此 其 中 的 代码 是 这 一 章 结束 时 的 状态 。 
使 用 Git 检查 进度 

如 果 想 进一步 提升 你 的 Git 技能 ， 可 以 添加 我 的 仓库 ， 作 为 一 个 远程 仓库 : 


git remote add harry https://github.com/hjwp/book-example.git 
git fetch harry 


然后 可 以 按照 下 面 的 方式 查看 第 4 章 结 束 时 你 我 代码 之 间 的 差异 : 
git diff harry/chapter_04 


Git 能 处 理 多 个 远程 仓库 ， 因 此 就 算 你 已 经 把 自己 的 代码 推送 到 GitHub 或 者 Bitbucket， 
也 可 以 这 么 做 。 


注意 ， 我 们 的 代码 顺序 可 能 不 完全 一 样 (例如 ， 类 中 的 方法 ) 。 这 可 能 会 导致 差异 信息 
难以 阅读 。 
下 载 各 章 代 码 的 ZIP 文件 


如 果 你 基于 某 些 原因 想 从 中 间 某 章 开始 阅读 ， 或 者 跳 着 阅读 *， 抑 或 不 习惯 使 用 Git， 
可 以 ZIP 文件 的 形式 下 载 我 的 代码 ， 下 载 地 址 遵从 下 面 的 格式 : 


。 https://github.com/hjwp/book-example/archive/chapter_05.zip 
。 https://github.com/hjwp/book-example/archive/chapter_06.zip 


不 要 依赖 我 的 代码 


除非 真 的 卡 住 了 ， 否则 不 要 偷 看 答案 。 就 像 我 在 前 一 章 开 头 所 说 的 ， 自 己 动手 调试 问 
题 能 学 到 很 多 知识 ， 而 且 在 现实 生活 中 并 没有 我 的 这 个 仓库 可 以 核对 ， 找 出 所 有 答案 。 




















注 3: 我 不 建议 跳 着 阅读 。 各 章 不 是 独立 的 ， 每 一 章 都 和 前 一 章 衔接 ， 因 此 跳 着 读 可 能 会 让 你 更 困惑 。 
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保存 用 户 输 入 





要 获取 用 户 输入 的 待 办 事项 ， 发 送 给 服务 器 ， 这 样 才能 使 用 某 种 方式 保存 待 办 事项 ， 然 后 
再 显示 给 用 户 查 看 。 

















刚 开始 写 这 一 章 时 ,我 立即 采用 了 我 认为 正确 的 设计 方式 : 为 清单 和 待 办 事项 创建 几 个 模 
型 ， 为 新 建 清单 和 待 办 事项 创建 一 组 不 同 的 URL， 编 写 三 个 新 视图 函数 ， 又 为 这 些 操作 编 
写 六 七 个 新 的 单元 测试 。 不 过 我 还 是 忍 住 了 没 这 么 做 。 虽 然 我 十 分 确定 自己 很 聪明 ， 能 一 
次 处 理 所 有 问题 ， 但 是 TDD 的 重要 思想 是 必要 时 一 次 只 做 一 件 事 。 所 以 我 决定 放 慢 脚步 ， 
每 次 只 做 必要 的 操作 ， 让 功能 测试 向 前 迈 出 一 小 步 即 可 。 


























Yy 








这 么 做 是 为 了 演示 TDD 对 迭代 式 开 发 方法 的 支持 一 一 这 种 方法 不 是 最 快 的 ， 但 最 终 仍 能 
把 你 带 到 目的 地 。 使 用 这 种 方法 还 有 个 不 错 的 附带 好 处 : 我 可 以 一 次 只 介绍 一 个 新 概念 ， 
例如 模型 、 处 理 POST 请 求 和 Django 模板 标签 等 ， 不 必 一 股 脑 儿 全 抛 给 你 。 


并 不 是 说 你 不 能 事先 考虑 后 面 的 事 ， 或 者 不 能 发 挥 自己 的 聪明 才 吞 。 下 一 章 我 们 会 稍微 多 
使 用 一 点 儿 设 计 和 预见 思维 ， 展 示 如 何在 TDD 过 程 中 运用 这 些 思维 方式 。 不 过 现在 ,我 
们 要 坚持 自己 是 无 知 的， 测试 让 做 什么 就 做 什么 。 


5.1 编写 表单 ， 发 送 POST 请 求 


上 一 章 末尾 ， 测 试 指出 无 法 保存 用 户 的 输入 。 现 在 ， 要 使 用 标准 的 HTML POST 请 求 。 
虽然 有 点 无 聊 ， 但 发 送 过 程 很 简单 。 后 文 我 们 会 见识 到 各 种 有 趣 的 HTML5 和 JavaScript 
用 法 。 
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若 想 让 浏览 器 发 送 POST 请 求 ， 要 给 <input> 元 素 指 定 name= 属性 ， 然 后 把 它 放 在 <form> 


一 fo 
标签 


请 求 。 


现在 运 





中 ， 并 为 <form> 标签 指定 method="P0ST" 属性 ， 这 样 浏 览 嚣 才能 向 服务 器 发 送 POST 
调整 一 下 lists/templates/home.html 中 的 模板 : 





lists/templates/home.html 


<h1>Your To-Do List</h1> 
<form method="POST"> 

<input name="item text" id="id new_item" placeholder="Enter a to-do item" /> 
</form> 


<table id="id list table"> 


行 功能 测试 ， 会 看 到 一 个 上 泡 难 懂 、 预 料 之 外 的 错误 : 














$ python3 functional_tests.py 
[...] 
Traceback (most recent call last): 

File "functional_tests.py", line 39, iin 
test_can_start a_list _and_retrieve it later 

table = self.browser.find element by _id('id list table') 

[...] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id list table"}' ; Stacktrace [...] 


如 果 功 能 测试 出 乎 意料 地 失败 了 ， 可 以 做 下 面 儿 件 事 ， 找 出 问题 所 在 : 


添加 print 语句 ， 输 出 页 面 中 当前 显示 的 文本 是 什么 ， 
改进 错误 消息 ， 显 示 当 前 状态 的 更 多 信息 ， 





。 亲自 手动 访问 网 站 ; 
。 在 测试 执行 过 程 中 使 用 time.steep 暂停 。 





本 书 








会 分 别 介绍 这 几 种 调试 方法 ， 不 过 我 发 现 自己 经 常 使 用 time.sleep。 下 面试 一 下 这 种 
方法 。 





We 外加 上 time.sLeep 











functional tests.py 


# 按 回 车 键 后 , 页面 更 新 了 
# 待 办 事项 表格 中 显示 了 "1: Buy peacock feathers" 
inputbox.send_keys(Keys.ENTER) 














import time 
time.sleep(10) 
table = self.browser.find element by _id('id list table') 











如 果 Selenium 运行 得 很 慢 ， 你 可 能 已 经 发 现 了 这 一 问题 。 现 在 再 次 运行 功能 测试 ， 就 有 机 
会 看 看 到 底 发 生 了 什么 rs 个 如 图 5-1 所 示 的 页 面 ， 显 示 了 Django 提供 的 很 多 调 
试 信息 。 
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403 Forbidden - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 
| 王 403 Forbidden | + | 
localhost801 v@@| | 图 v Google QI 分 


Forbidden (4o3) 
CSRF verification failed, Request aborted， 


Help 


Reason given for failure: 
CSRF cookie not set 


In general, this can occur when there is a genuine Cross Site Request Forgery, or when Django's CSRF mechanism has not been used 
correctly. For POST forms, you need to ensure: 


® Your browser is accepting cookies， 

e The view function Uses RequestContext for the template, instead of Context. 

se Inthe template, there is a {% csrf_token %} template tag inside each POST form that targets an internal URL. 

® Ifyou are not using CsrfViewMiddleware, then you mmust Use csrf_protect ON any views that use the csrf_token template 
tag, as well as those that accept the POST data., 从 

You're seeing the help section of this page because you have DEBUG = Truein your Django settings file. Change that to False, and only the 

initial error message will be displayed. 


You can customize this page using the CSRF_FAILURE_VIEW setting. 


X WebDriver 











图 5-1: Django 中 的 调试 页 面 ， 显 示 有 CSRF 错误 





如 果 你 从 未 听 说 过 “ 跨 站 请 求 伪 造 ”(Cross-Site Request Forgery，CSRF) 漏洞 ， 现 在 
就 去 查 资 料 吧 。 和 所 有 安全 漏洞 一 样 ， 研 究 起 来 很 有 趣 。CSREF 是 一 种 不 寻常 的 、 使 
用 系统 的 巧妙 方式 。 


在 大 学 攻读 计算 机 科学 学 位 时 ， 出 于 责任 感 ， 我 报名 学 习 了 安全 课程 单元 。 这 个 单元 可 
能 很 枯燥 乏味 ， 但 我 觉得 最 好 还 是 学 一 下 。 结 果 证 明 ， 这 是 所 有 课程 中 最 吸引 人 的 单 
元 ， 充 满 了 黑客 的 乐趣 ， 你 要 在 特定 的 心境 下 思考 如 何 通过 意 想不到 的 方式 使 用 系统 。 


我 要 推荐 学 这 门 课程 时 使 用 的 课本 ，Ross Anderson 写 的 Security Engineering。 这 本 书 
没有 深入 讲解 纯粹 的 加 密 机 制 ， 而 是 讨论 了 很 多 意料 之 外 的 话题 ， 例 如 开锁 、 伪 造 银 
行 票 据 和 喷 墨 打印 机 墨盒 的 经 济 原理 ， 以 及 如 何 使 用 “ 重 放 攻 击 ”(replay attack) 戏 
型 南非 空军 的 飞机 等 。 这 是 本 大 部 头 书 ， 大 约 3 英寸 厚 ， 但 相信 我 ， 绝 对 值得 一 读 。 











Django 针对 CSRF 的 保护 措施 是 在 生成 的 每 个 表单 中 放置 一 个 自动 生成 的 令 牌 ， 通 过 这 个 
令 牌 判断 POST 请 求 是 否 来 自 同一 个 网 站 。 
之 前 的 模板 都 是 纯粹 的 HTML， 在 这 里 要 首次 体验 Django 模板 的 魔力 ， 使 用 “模板 标签 ” 


(template tag) 添加 CSRF 令 牌 。 模 板 标签 的 句法 是 花 括 号 和 百 分 号 形式 ， 即 {% ..， 只 
这 种 写法 很 有 名 ， 要 连续 多 次 同时 按 两 个 键 ， 是 世界 上 最 麻烦 的 输入 方式 。 
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lists/templates/home.html 


<form method="POST"> 
<input name="item text" id="id new item" placeholder="Enter a to-do item" /> 
{% csrf_token %} 

</form> 


泻 染 模板 时 ，Django 会 把 这 个 模板 标签 替换 成 一 个 <input type="hidden"> 元素 ， 其 值 是 
CSRF 令 牌 。 现 在 运行 功能 测试 ， 会 看 到 一 个 预期 失败 : 





AssertionError: False is not true : New to-do item did not appear in table 


因为 time.sleep 还 在 ， 所 以 测试 会 在 最 后 一 屏 上 暂停 。 可 以 看 到 ， 提 交 表 单 后 新 添加 的 
待 办 事项 不 见 了 ， 页 面 刷新 后 又 显示 了 一 个 空 表 单 。 这 是 因为 还 设 连 接 服务 器 让 它 处 至 
POST 请 求 ， 所 以 服务 器 忽略 请 求 ， 直 接 显示 常规 首页 。 









































T 





其 实 ， 现 在 可 以 删 掉 ttme.sLeep 了 : 


functional tests.py 





# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers” 
inputbox.send_keys(Keys.ENTER) 





table = self.browser.find element by _id('id list table') 


5.2 在 服务 器 中 处 理 POST 请 ; 


还 没 为 表单 指定 action= 属性 ， 因 此 提交 表单 后 默认 返回 之 前 渲染 的 页 面 ， 即 “/， 这 个 
页 面 由 视图 函数 home_page 处 理 。 下 面 修改 这 个 视图 函数 ， 让 它 能 处 理 POST 请 求 。 













































































这 意味 着 要 为 视图 函数 home_page 编写 一 个 新 的 单元 测试 。 打 开 文 件 lists/tests.py， 在 
HomePageTest 类 中 添加 一 个 新 方法 。 我 复制 了 前 一 个 方法 ， 然 后 做 些 修改 ， 在 其 中 添加 
POST 请 求 ， 再 检查 返回 的 HTML 中 是 否 有 新 添加 的 待 办 事项 文本 : 


























lists/tests.py (ch051005) 


def test home page_returns_correct_html(self): 


a] 


def test home page_can_save_a_POST_request(self): 
request = HttpRequest() 
request.method = 'POST' 
request.POST['item text'] = 'A new list item' 


response = home_page(request) 
self.assertIn('A new list item', response.content.decode()) 





你 想 知 道 为 什么 要 在 测试 中 添加 一 个 空 行 吗 ? 我 把 开头 三 行 放 在 一 起 ， 作 用 
是 设置 测试 的 背景 ,然后 在 中 间 添 加 一 行 调用 要 测试 的 函数 ， 最 后 编写 断 
言 。 这 么 做 并 不 是 强制 要 求 ,， 但 可 以 看 清 测 试 的 结构 。“ 设 置 配置 -执行 代 
码 - 编写 断言 ”是 单元 测试 的 典型 结构 。 


















































可 以 看 出 ， 用 到 了 HttpRequest 的 儿 个 特殊 属性 : .method 和 :POST (它们 的 作用 很 明 
显 ， 不 过 或 许可 以 借 此 机 会 阅读 Diango 关于 请 求 和 响应 的 文档 ， 地 址 是 https://docs. 
djangoproject.com/en/1.7/ref/request-response/)。 然 后 再 检查 POST 请 求 演 染 得 到 的 HTML 
中 是 否 有 指定 的 文本 。 运 行 测试 后 ， 会 看 到 预期 的 失败 : 

$ python3 manage.py test 

[...] 


AssertionError: 'A new list item' not found in '<html> [...] 


为 了 让 测试 通过 ， 可 以 添加 一 个 if 语句 ， 为 POST 请 求 提供 一 个 不 同 的 代码 执行 路 径 。 按 
照 典 型 的 TDD 方式 ， 先 故意 编写 一 个 愚蠢 的 返回 值 : 


lists/views.py 


from django.http import HttpResponse 
from django.shortcuts import render 


def home_page(request): 
if request.method == 'POST': 
return HttpResponse(request.POST['item_ text']) 
return render(request, 'home.html') 





这 样 单元 测试 就 能 通过 了 ， 但 这 并 不 是 我 们 真正 想 要 做 的 。 我 们 真正 想 要 做 的 是 ， 把 
POST 请 求 提交 的 数据 添加 到 首页 模板 的 表格 里 。 


5.3 把 Python 变 量 传 入 模板 中 泻 


前 面 已 经 粗略 展示 了 Django 的 模板 句法 ， 现 在 是 时 候 领 略 它 的 真正 强大 之 处 了 ， 即 从 视 
图 的 Python 代码 中 把 变量 传 入 HTML 模板 。 








一 | 














先 介绍 在 模板 中 使 用 哪 种 句法 引入 Python 对 象 。 要 使 用 的 符号 是 {{ .二 }， 它 会 以 字符 
串 的 形式 显示 对 象 ; 





lists/templates/home.html 
<body> 
<h1>Your To-Do list</hi> 
<form method="POST"> 
<input name="item text" id="id new item" placeholder="Enter a to-do item" /> 
{% csrf_token %} 
</form> 


<table id="id list table"> 
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<tr><td>{{ new_item text }}</td></tr> 
</table> 
</body> 





怎么 测试 视图 函数 为 new_item_text 传 入 的 值 正确 呢 ” 又 怎么 把 变量 传 入 模板 呢 ?” 可 以 
在 单元 测试 中 实际 操作 一 遍 找 出 这 两 个 问题 的 答 答案 。 在 前 一 个 单元 测试 中 已 经 用 到 了 
render_to_string 函数 ， 用 它 手 动 渲染 模板 ， 然 后 拿 它 的 返回 值 和 视图 函数 返回 的 HTML 
比较 。 下 面 添加 想 传 入 的 变量 




















lists/tests.py 


self.assertIn('A new list item', response.content.decode()) 
expected_html = render_to_string( 

'home.html', 

{'new_item text': 'A new list item'} 
) 


self.assertEqual(response.content.decode(), expected_ html) 


可 以 看 出 ，render_to_string 国 数 的 第 二 个 参数 是 变量 名 到 值 的 映射 。 向 模板 中 传人 了 一 
个 名 为 new_item_text 的 变量 ， 甚 值 是 期 望 在 POST 请 求 中 发 送 的 待 办 事项 文本 。 











运行 这 个 单元 测试 时 ，render_to_string 函数 会 把 <td> 中 的 {{ new_item_text }} 赫 换 成 
“A new list item”。 视 图 函数 目前 还 无 法 做 到 这 一 点 ， 因 此 会 看 到 测试 失败 : 





self.assertEqual(response.content.decode(), expected_html) 
AssertionError: 'A new list item' != '<html>\n <head>\n [...] 





很 好 ， 故 意 编写 的 愚蠢 返回 值 已 经 骗 不 过 测试 了 ， 因 此 要 重 写 视图 函数 ， 把 POST 请 求 中 
的 参数 传人 模板 : 








lists/views.py (ch051009) 


def home_page(request): 
return render(request, 'home.html', { 
'New_item text': request.POST['item text'], 


}) 
然后 再 运行 单元 测试 





ERROR: test_home_page_returns_correct_htmL (Lists.tests.HomePageTest) 


be] 
'Nnew_item_ text': request.POST['item text'], 
KeyError: 'item text' 


看 到 的 是 意料 之 外 的 失败 。 


如 果 你 记得 阅读 调用 跟踪 的 方法 ， 就 会 发 现 这 次 失败 其 实 发 生 在 另 一 个 测试 中 。 我 们 让 正 
在 处 理 的 测试 通过 了 ， 但 是 这 个 单元 测试 却 导 致 了 一 个 意 想不到 的 结果 ， 或 者 称 之 为 “ 回 
归 ”: 破坏 了 没有 POST 请 求 时 执行 的 那 条 代码 路 径 。 


















































这 就 是 测试 的 要 义 所 在 。 不 错 ， 发 生 这 样 的 事 是 可 以 预料 的 ， 但 如 果 运 气 不 好 或 者 没有 注 
意 到 呢 ?” 这 时 测试 就 能 避免 破坏 应 用 功能 ， 而 且 ， 因 为 我 们 在 使 用 TDD， 所 以 能 立即 发 现 
什么 地 方 有 问题 。 无 需 等 待 质 量 保证 团队 的 反馈 ， 也 不 用 打开 浏览 器 自己 动手 在 网 站 中 点 
来 点 去 ， 直 接 就 能 修正 问题 。 这 次 失败 的 修正 方法 如 下 : 














x 


lists/views.py 


def home_page(request): 
return render(request, 'home.html', { 
'New_item text': request.POST.get('item text', ''), 
}) 


如 果 不 理解 这 段 代 码 ， 可 以 查阅 dict.get 的 文档 (http://docs.python.org/3/library/stdtypes. 
html#dict.get )。 








这 个 单元 测试 现在 应 该 可 以 通过 了 。 看 一 下 功能 测试 的 结果 如 何 : 


AssertionError: False is not true : New to-do item did not appear in table 





错误 消息 没 太 大 帮助 。 使 用 另 一 种 功能 测试 的 调试 技术 : 改进 错误 消息 。 这 或 许 是 最 有 建 
设 性 的 技术 ， 因 为 改进 后 的 错误 消息 一 直 存 在 ， 可 以 协助 调试 以 后 出 现 的 错误 : 





functional tests.py 


self.assertTrue( 
any(row.text == '1: Buy peacock feathers' for row in rows), 
"New to-do item did not appear in table -- its text was:\n%s" % ( 
tabLe .text， 
) 
) 


改进 后 ， 测 试 给 出 了 更 有 用 的 错误 消息 : 


AssertionError: False is not true : New to-do item did not appear in table -- 
its text was: 
Buy peacock feathers 














知道 怎么 改 效果 更 好 吗 ? 稍微 让 断言 别 那么 灵巧 。 你 可 能 还 记得 ， 国 数 any 让 我 很 满 
意 ， 但 预览 版 的 一 个 读者 (感谢 Jason ! ) 建议 我 使 用 一 种 更 简单 的 实现 方式 ， 把 六 行 


assertTrue 换 成 一 行 assertIn: 








functional tests.py 


self.assertIn('1: Buy peacock feathers', [row.text for row in rows]) 








这 样 好 多 了 。 自 作 聪 明 时 一 定 要 小 心 ， 因 为 你 可 能 把 问题 过 度 复杂 化 了 。 修 改 之 后 自动 获 
得 了 下 面 的 错误 消息 : 




















seLf .assertIn('1: Buy peacock feathers', [row.text for row in rows]) 
AssertionError: '1: Buy peacock feathers' not found in ['Buy peacock feathers'] 
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就 当 这 是 我 应 得 的 惩罚 吧 。 上 述 错误 消息 的 意思 是 ， 功 能 测试 在 枚 举 列 表 中 的 项 目 时 希望 
第 一 个 项 目 以 “1:” 开 头 。 让 测试 通 过 最 快 的 方法 是 修改 模板 时 “作弊 ”: 








lists/templates/home.html 
<tr><td>1: {{ new_item text }}</td></tr> 








“ 遇 红 / 变 绿 / 重 构 ” 和 三 角 法 
“单元 测试 /编写 代码 ”循环 有 时 也 叫 “ 遇 红 / 变 绿 / 重 构 ”: 





。 先 写 一 个 会 失败 的 单元 测试 〈 遇 红 ) ; 
。 编写 尽 可 能 简单 的 代码 让 测试 通过 ( 变 绿 )， 就 算 作 次 也 行 
。 重 构 ， 改 进 代码 ， 让 其 更 合理 。 


那么 ， 在 重 构 阶段 应 该 做 些 什么 呢 ? 如 何 判 断 什么 时 候 应 该 把 作 次 的 代码 改 成 令 我 们 
满意 的 实现 方式 呢 ? 


一 种 方法 是 消除 重复 ; 如 果 测 试 中 使 用 了 神奇 常量 (例如 列表 项 目前 面 的 “1:”) ， 而 
且 应 用 代码 中 也 用 了 这 个 常量 ， 这 就 算是 重复 ， 此 时 就 应 该 重 构 。 把 神奇 常量 从 应 用 
代码 中 删 掉 往往 意味 着 你 不 能 再 作 县 了 。 


我 觉得 这 种 方法 有 点 不 太 明确 ， 所 以 经 常 使 用 第 二 种 方法 ， 这 种 方法 叫 作 “三 角 法 ”: 
如 果 编 写 无 法 让 你 满意 的 作 痊 代码 (例如 返回 一 个 神奇 的 常量 ) 就 能 让 测试 通过 ， 就 
再 写 一 个 测试 ， 强 制 自己 编写 更 好 的 代码 。 现 在 就 要 使 用 这 种 方法 ， 扩 充 功 能 测试 ， 
检查 输入 的 第 二 个 列表 项 目 中 是 否 包含 “2:”。 











现在 功能 测试 能 执行 到 self.fail('Finish the test! ) 了 。 如 果 扩 充 功 能 测试 ， 检 查 表格 


中 











添加 的 第 二 个 待 办 事项 (复制 粘贴 是 好 帮手 )， 我 们 会 发 现 刚才 使 用 的 简单 处 理 方式 不 


奏效 了 : 


functional tests.py 





# 页 面 中 还 有 一 个 文本 框 , 可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use peacock feathers to make a fly”( 使 用 孔雀 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 

inputbox = self.browser.find element_by_id('id new item') 
inputbox.send_keys('Use peacock feathers to make a fly') 
inputbox.send_keys(Keys.ENTER) 


























# 页 面 再 次 更 新 ,清单 中 显示 了 这 两 个 待 办 事项 
table = self.browser.find element by _id('id list table') 
rows = table.find elements_by_tag_name('tr') 
self.assertIN( 1: Buy peacock feathers', [row.text for row in rows]) 
seLf .assertIn( 
'2: Use peacock feathers to make a fly' ， 
[row.text for row in rows] 




















# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
# 她 看 到 网 站 为 她 生成 了 一 个 唯一 的 URL 

# 页 面 中 有 一 些 文字 解说 这 个 功能 
self.fail('Finish the test!') 





# 她 访问 那个 URL, 发 现 待 办 事项 清单 还 在 








很 显然 ， 这 个 功能 测试 会 返回 一 个 错误 : 


AssertionError: '1: Buy peacock feathers' not found in ['1: Use peacock 
feathers to make a fly'] 


5.4 事 不 过 三 ， 三 则 重 构 


在 继续 之 前 ， 先 看 一 下 功能 测试 中 的 代码 异味 。' 检查 清单 表格 中 新 添加 的 待 办 事项 时 ， 用 
了 三 个 几乎 一 样 的 代码 块 。 编 程 中 有 个 原则 叫 作 “不 要 自我 重复 ”(Don’t Repeat Yourself， 
DRY) ， 按 照 真 言 “ 事 不 过 三 ,三 则 重 构 ” 的 说 法 ， 运 用 这 个 原则 。 复 制 粘贴 一 次 ， 可 能 
还 不 用 删除 重复 ， 但 如 果 复 制 粘 贴 了 三 次 ， 就 该 删除 重复 了 。 





























要 先 提 交 目 前 已 编写 的 代码 。 虽 然 网 站 还 有 重大 环 症 (只 能 处 理 一 个 待 办 事项 )， 但 仍然 
取得 了 一 定 进展 。 这 些 代 码 可 能 要 全 部 重 写 ， 也 可 能 不 用 ， 不 管 怎样 ， 重 构 之 前 一 定 要 


提交 : 














让 





$ git diff 
# 会 看 到 functional_tests.py,home.html,tests.py 和 views .py 中 的 变动 
$ git commit -a 


然后 重 构 功 能 测试 。 可 以 定义 一 个 行 间 函数 ， 不 过 这 样 会 稍微 搅乱 测试 流程 ， 还 是 用 辅助 
方法 吧 。 记 住 ， 只 有 名 字 以 test_ 开头 的 方法 才 会 作为 测试 运行 ， 可 以 根据 需求 使 用 其 他 
方法 。 





functional tests.py 


def tearDown(self): 
self.browser .quit() 


def check_for_row in list table(self, row_text): 
table = self.browser.find element by id('id list table') 
rows = table.find elements_by_tag_name('tr') 
self.assertIn(row_text, [row.text for row in rows]) 


def test can_start a_list and_retrieve it later(self): 


[2 





: 如 果 你 没 遇 到 过 这 个 概念 ， 我 告诉 你 ,“ 代 码 异 味 ” 表 明 一 段 代码 需要 重 写 。Jeff Atwood 在 他 的 博客 
Coding Horror 中 (http://blog.codinghorror.com/code-smells/) 搜 集 了 很 多 这 方面 的 资料 ,编程 经 验 越 丰富 ， 
你 的 鼻子 就 会 变 得 越 灵 敏 ， 能 够 嗅 出 代码 中 的 异味 。 


mm 
出 
a 
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我 喜欢 把 辅助 方法 放 在 类 的 顶部 ， 置 于 tearDown 和 第 一 个 测试 之 间 。 下 面 在 功能 测试 中 使 
用 这 个 辅助 方法 : 


functional tests.py 





# 她 按 回 车 键 后 , 页面 更 新 了 

# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers” 
inputbox.send_keys(Keys.ENTER) 
self.check_for_row_in list table('1: Buy peacock feathers') 

















# 页 面 中 又 显示 了 一 个 文本 框 ,可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use peacock feathers to make a fly”( 使 用 孔雀 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 

inputbox = self.browser.find element_ by_id('id new item') 
inputbox.send_keys('Use peacock feathers to make a fly') 
inputbox.send_keys(Keys.ENTER) 




















# 页 面 再 次 更 新 ,她 的 清单 中 显示 了 这 两 个 待 办 事项 
self.check_for_row_in list table('1: Buy peacock feathers') 
self.check_for_row_in list table('2: Use peacock feathers to make a fly') 

















ey 





# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
[...] 


再 次 运行 功能 测试 ， 看 重 构 前 后 的 表现 是 否 一 致 ; 


AssertionError: '1: Buy peacock feathers' not found in ['1: Use peacock 
feathers to make a fly'] 


很 好 。 接 下 来 ， 提 交 这 次 针对 功能 测试 的 小 重 构 : 





$ git diff # 查看 functional_tests.py 中 的 改动 
$ git commit -a 








继续 开发 工作 。 如 果 要 处 理 不 止 一 个 待 办 事项 ， 需 要 某 种 持久 化 存储 ， 在 Web 应 用 领域 ， 
数据 库 是 一 种 成 熟 的 解决 方案 。 





5.5 ”Django ORM 和 第 一 个 模型 


“对 象 关系 映射 器 ”(Object-Relational Mapper，ORM) 是 一 个 数据 抽象 层 ， 描 述 存 储 在 数 
据 库 中 的 表 、 行 和 列 。 处 理 数据 库 时 ， 可 以 使 用 熟悉 的 面向 对 象 方式 ， 写 出 更 好 的 代码 。 
在 ORM 的 概念 中 ， 类 对 应 数据 库 中 的 表 ， 属 性 对 应 列 ， 类 的 单个 实例 表示 数据 库 中 的 一 


行 数据 。 
































Django 对 ORM 提供 了 良好 的 支持 ， 学 习 ORM 的 绝 佳 方法 是 在 单元 测试 中 使 用 它 ， 因 为 

















单元 测试 能 按照 指定 方式 使 用 ORM。 








下 者 





i 在 lists/tests.py 文件 中 新 建 一 个 类 : 
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lists/tests.py 


from lists.models import Item 


Lxs] 
class ItemModelTest(TestCase): 


def test _ saving_and_retrieving items(self): 
first item = Item() 
first item.text = 'The first (ever) list item 
first_item.save() 


second_item = Item() 
second_item.text = 'Item the second ' 
second_itenm. save() 


saved_items = Item.objects.all() 
self.assertEqual(saved items.count(), 2) 


first_saved_item = saved_items[0] 

second_saved item = saved items[1] 
self.assertEqual(first saved_ item.text, 'The first (ever) list item') 
seLf .assertEquaL(second_saved_item.text， 'Item the second') 

















由 上 述 代 码 可 以 看 出 ， 在 数据 库 中 创建 新 记录 的 过 程 很 简单 : 先 创建 一 个 对 象 ， 再 为 一 些 属 
性 赋值 ， 然 后 调用 .save() 国 数 。Django 提供 了 一 个 查询 数据 库 的 API， 即 类 属性 .objects。 
再 使 用 可 能 是 最 简单 的 查询 方法 .atL()， 取 回 这 个 表 中 的 全 部 记录 。 得 到 的 结果 是 一 个 类 
似 列表 的 对 象 ， 叫 Queryset。 从 这 个 对 象 中 可 以 提取 出 单个 对 象 ， 然 后 还 可 以 再 调用 其 他 图 
数 ， 例 如 ,count()。 接 着 ， 检 查 存储 在 数据 库 中 的 对 象 ， 看 保存 的 信息 是 否 正确 。 


Django 中 的 ORM 有 很 多 有 用 且 直 观 的 功能 。 现 在 可 能 是 略 读 Django 教程 (https://docs. 
djangoproject.com/en/1.7/intro/tutorial01/) 的 好 时 机 ， 这 个 教程 很 好 地 介绍 了 ORM 的 功能 。 
































这 个 单元 测试 写 得 很 鹃 嗪 ， 因 为 我 想 借 此 介绍 Django ORM。 其 实 模 型 类 的 
测试 可 以 很 简短 ， 在 第 11 章 会 看 到 。 








术语 2: 单元 测试 和 集成 测试 的 区 别 以 及 数据 库 
追求 纯粹 的 人 会 告诉 你 ， 真 正 的 单元 测试 绝 不 能 涉及 数据 库 操 作 。 我 刚 编写 的 测试 或 
许 叫 作 “ 整 合 测试 ”(Integrated Test) 更 确切 ， 因 为 它 不 仅 测试 代码 ， 还 依赖 于 外 部 系 
统 ， 即 数据 库 。 


现在 可 以 忽略 这 种 区 别 ， 因 为 有 两 种 测试 ， 一 种 是 功能 测试 ， 从 用 户 的 角度 出 发 ， 站 
在 一 定 高 度 上 测试 应 用 ; 另 一 种 从 程序 员 的 角度 出 发 ， 做 底层 测试 。 


在 第 19 章 会 再 次 讨论 单元 测试 和 整合 测试 。 





























保存 用 户 输入 | 55 


试 着 运行 单元 测试 。 接 下 来 要 进入 另 一 次 “单元 测试 / 编写 代码 ”循环 : 





ImportError: cannot import name 'Item' 

















很 好 。 下 面 在 lists/models.py 中 写 入 一 些 代码 ， 让 它 有 内 容 可 导入 。 我 们 有 自信 ， 因 此 会 
跳 过 编写 Item = None 这 一 步 ， 直 接 创 建 类 : 





lists/models.py 


from django.db import models 


class Item(object): 
pass 


这 些 代码 让 测试 向 前 进展 到 了 : 


first_item.save() 
AttributeError: 'Item' object has no attribute "save' 











为 了 给 Iten 类 提供 save 方法， 也 为 了 让 这 个 类 变 成 真正 的 Django 模型 ， 要 让 它 继 承 
Model 类 





lists/models.py 


from django.db import models 


class Item(models.Model): 
pass 


5.5.1 第 一 个 数据 库 迁 移 


再 次 运行 测试 ， 会 看 到 一 个 数据 库 错 误 : 





first_ item.save() 
File "/usr/local/lib/python3.4/dist-packages/django/db/models/base.py", line 
593,in save 
[...] 
return Database.Cursor .execute(self, query, params) 
django.db.utils.OperationalError: no such table: lists_ item 














在 Django 中 ，ORM 的 任务 是 模型 化 数据 库 。 创 建 数据 库 其 实 是 由 另 一 个 系统 负责 的 ， 叫 
作 “ 迁 移 ”(migration)。 迁 移 的 任务 是 ， 根 据 你 对 models.py 文件 的 改动 情况 ， 添 加 或 删 
除 表 和 列 。 

你 可 以 把 迁移 想象 成 数据 库 使 用 的 版 本 控制 系统 。 后 面 会 看 到 ， 把 应 用 部 署 到 线 上 服务 器 
升级 数据 库 时 ， 迁 移 十 分 有 用 。 


现在 只 需要 知道 如 何 创建 第 一 个 数据 库 迁 移 一 一 使 用 makemigrations 命令 创建 迁移 : 






































$ python3 manage.py makemigrations 
Migrations for 'lists': 
0001_initial.py: 
- Create model Item 
$ Ls lists/migrations 
0001 initial.py _ init .py __pycache _ 








如 果 好 奇 ， 可 以 看 一 下 迁移 文件 中 的 内 容 ， 你 会 发 现 ， 这 些 内 容 表 明了 在 models.py 文件 
中 添加 的 内 容 。 


与 此 同时 ， 应 该 会 发 现 测试 又 取得 了 一 点 进展 。 


5.5.2 ”测试 向 前 走 得 挺 远 
其 实 ， 测 试 向 前 走 得 还 托 远 ， 





$ python3 manage.py test lists 
Exeaa] 
self.assertEqual(first_ saved item.text, 'The first (ever) list item') 
AttributeError: 'Item' object has no attribute 'text' 


这 离 上 次 失败 的 位 置 整整 八 行 。 在 这 八 行 代码 中 ， 保 存 了 两 个 待 办 事项 ， 检 查 它们 是 否 存 
入 了 数据 库 。 可 是 ，Django 似乎 不 记得 有 .text 属性 。 








如 有 果 你 刚 接触 Python， 可 能 会 觉得 意外 ， 为 什么 一 开始 能 给 .text 属性 赋值 呢 ? 在 Java 等 
语言 中 ， 本 应 该 得 到 一 个 编译 错误 。 但 是 Python 对 这 种 用 法 要 求 更 宽松 。 


继承 models.Model 的 类 映射 到 数据 库 中 的 一 个 表 。 默 认 情 况 下 ， 这 种 类 会 得 到 一 个 自动 生 
成 的 id 属性 ， 作 为 表 的 主键 ， 但 是 其 他 列 都 要 自行 定义 。 定 义 文本 字段 的 方法 如 下 : 





























lists/models.py 


class Item(models.Model): 
text = models.TextField() 


Django 提供 了 很 多 其 他 字段 类 型 ， 例 如 IntegerField、CharField、DateField 等 。 使 用 
TextField 而 不 用 CharFieLd， 是 因为 后 者 需要 限制 长 度 ， 但 是 就 目前 而 言 ， 这 个 字段 的 长 
度 是 随意 的 。 关 于 字段 类 型 的 更 多 介绍 可 以 阅读 Django 教程 (https://docs.djangoproject. 
com/en/1.7/intro/tutorial01/#creating-models) 和 文档 (https://docs.djangoproject.com/en/1.7/ 
ref/models/fields/) 。 








5.5.3 ”添加 新 字段 就 要 创建 新 迁移 
运行 测试 ， 会 看 到 另 一 个 数据 库 错误 : 


django.db.utils.OperationalError: table lists item has no column named text 




















保存 用 户 输 入 | 57 





出 现 这 个 错误 的 原因 是 在 数据 库 中 添加 了 一 个 新 字段 ， 所 以 要 再 创建 一 个 迁移 。 测 试 能 告 
诉 我 们 这 一 点 真是 太 好 了 | 


创建 迁移 试 试 ; 








$ python3 manage.py makemigrations 
You are trying to add a non-nullable field 'text' to item without a default; 
we can't do that (the database needs something to populate existing rows). 
Please select a fix: 

1) Provide a one-off default now (will be set on all existing rows) 

2) Quit, and let me add a default in models.py 

Select an option:2 


个 命令 不 允许 添加 没有 默认 值 的 列 。 选 择 第 二 个 选项 ， 然 后 在 models.py 中 设 定 一 个 默 
WE 我 想 你 会 发 现 所 用 的 句法 无 需 过 多 解释 : 














lists/models.py 


class Item(models.Model): 
text = models.TextField(default=") 


现在 应 该 可 以 顺利 创建 迁移 了 : 


$ python3 manage.py makemigrations 
Migrations for 'lists': 
0002_item text.py: 
- Add field text to item 


ed 创建 了 两 个 数据 库 迁 移 ， 由 此 得 到 的 结果 是 ， 模 型 对 
text 属性 能 被 识别 为 一 个 特殊 属性 了 ， 因 此 属性 的 值 能 保存 到 数据 库 中 ， 测 试 也 


























$ python3 manage.py test lists 
[...] 


Ran 4 tests in 0.010s 
OK 








下 面 提交 创建 的 第 一 个 模型 : 











$ git status # 看 到 tests.py 和 models.py, 以 及 两 个 没 跟 踪 的 迁移 文件 
$ git diff # 审查 tests.py 和 models .py 中 的 改动 

$ git add lists 

$ git commit -m"Model for list Items and associated migration" 


5.6 把 POST 请 求 中 的 数据 存 入 数据 库 


接 下 来 ， 要 修改 针对 首页 中 POST 请 求 的 测试 。 希 望 视图 把 新 添加 的 待 办 事项 存 和 人 数据 
库 ， 而 不 是 直接 传 给 响应 。 为 了 测试 这 个 操作 ， 要 在 现 有 的 测试 方法 test_home_page_can_ 























save_a_P0ST_request 中 添加 三 行 新 代码 : 


lists/tests.py 


def test home page_can_save_a_POST_request(self): 


request = HttpRequest() 
request.method = 'POST' 
request.POST['item text'] = 'A new list item' 


response = home_page(request) 


seLf .assertEquaL(Item.objects.count()，1) #0 
New_item = Item.objects.first() #@ 
self.assertEqual(new_item.text, 'A new list item' ) #@ 


self.assertIn('A new list item', response.content.decode()) 
expected_html = render_to_string( 

'home.html’', 

{'new_item text': 'A new list item'} 
) 


self.assertEqual(response.content.decode(), expected_html) 


@ 检查 是 否 把 一 个 新 Itemn 对 象 存 信 数据库。objects.count() 是 objects.all().count() 
的 简写 形式 。 
@ objects.first() 等 价 于 objects.aLL()[0]。 


@ 检查 待 办 事项 的 文本 是 否 正确 。 





这 个 测试 变 得 有 点 儿 长 ， 看 起 来 要 测试 很 多 不 同 的 东西 。 这 也 是 一 种 代码 异味 。 长 的 单元 


测试 可 








以 分 解 成 两 个 ， 或 者 表明 测试 太 复杂 。 我 们 把 这 个 问题 记 在 自己 的 待 办 事项 清单 





中 ， 或 许可 以 写 在 一 张 便签 上 “: 











。 代 码 异 味 : poOST 请 求 的 测试 太 长 吗 ? 














记 在 便签 上 就 不 会 忘记 。 然 后 在 合适 的 时 候 再 回来 解决 。 再 次 运行 测试 ， 会 看 到 一 个 预期 
失败 : 
seLf .assertEquaL(Item.objects.count()，1) 
AssertionError: 0 != 1 








注 2: 这 张 便签 由 儿 张 图 片 合成 。 一 一 译 者 注 
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修改 一 下 视图 : 


lists/views.py 


from django.shortcuts import render 
from lists.models import Item 


def home_page(request): 
item = Item() 
item.text = request.POST.get('item text', '') 
item.save() 


return render(request, 'home.html', { 
'New_item text': request.POST.get('item text', ''), 


}) 
我 使 用 的 方法 很 天 真 ， 你 或 许 能 发 现 有 一 个 明显 的 问题 : 每 次 请 求 首 页 都 保存 一 个 无 内 容 
的 待 办 事项 。 把 这 个 问题 记 在 便签 上 ， 稍 后 再 解决 。 要 知道 ， 除 了 这 个 明显 的 严重 问题 之 
外 ， 目 前 还 无 法 为 不 同 的 用 户 创建 不 同 的 清单 。 暂 且 忽 略 这 些 问 题 。 























记 住 ， 并 不 是 说 在 实际 的 开发 中 始终 要 把 这 种 明显 的 问题 忽略 。 预 见 到 问题 时 ， 要 做 出 判 
断 ， 是 停止 正在 做 的 事 从 头 再 来 ， 还 是 暂时 不 管 ， 以 后 再 解决 。 有 时 完成 手头 的 工作 是 可 
以 接受 的 做 法 ， 但 有 些 时 候 问题 可 能 很 严重 ， 必 须 停 下 来 重新 思考 。 




















看 一 下 单元 测试 的 进展 如 何 …… 通 过 了 ， 太 好 了 ! 现在 可 以 做 些 重 构 : 


lists/views.py 


return render(request, 'home.html', { 
'New_item text': item.text 


]) 
看 一 下 便签 ， 我 添加 了 好 几 条 其 他 事 ， 











* 不 要 科 次 请 求 都 保存 空白 的 待 办 事项 
。 代 码 异 味 : POST 请 求 的 测试 太 长 吗 ? 
。 在 表格 中 显示 多 个 待 办 事项 

。 支 持 多 个 清单 ! 





区 自 抽 6 ”全 


Ap， 人 AAA 














先 看 第 
一 件 事 。 





一 个 问题 。 虽 然 可 以 在 现 有 的 测试 中 添加 一 个 断言 ， 但 最 好 让 单元 测试 一 次 只 测试 








那么 ， 定义 一 个 新 测试 方法 吧 ， 





lists/tests.py 


class HomePageTest(TestCase) : 


[sad] 


def test_ home page_only_saves_items when_necessary(self): 
request = HttpRequest() 
home_page(request) 
self.assertEqual(Item.objects.count(), 0) 





这 个 测试 得 到 的 是 1 != 6 失败 。 下 面 来 修正 这 个 问题 。 注 意 ， 虽 然 对 视图 函数 的 逻辑 改动 
幅度 很 小 ， 但 代码 的 实现 方式 有 很 多 细微 的 变动 : 


lists/views.py 


def home_page(request): 


@ 





if request.method == "POST ' : 
New_item text = request.POST['item text'] #©@ 
Item.objects.create(text=new_item text) #@ 
else: 
new_item text = '' #@ 


return render(request, 'home.html', { 
'New_item text': new item text, #@ 
}) 
使 用 一 个 名 为 new_item_text 的 变量 ， 其 值 是 POST 请 求 中 的 数据 ， 或 者 是 空 字 
符 串 。 


.objects.create 是 创建 新 Iten 对 象 的 简化 方式 ， 无 需 再 调用 .save() 方法 。 




















这 样 修改 之 后 ， 测 试 就 通过 了 : 


Ran 5 tests in 0.010s 


OK 


处 理 完 POST 请 求 后 重 定 回 


可 是 new_item_text = ”还 是 让 我 高 兴 不 起 来 。 幸 好 解决 便签 上 的 第 二 个 问题 时 有 机 会 























顺带 解决 这 个 问题 。 人 们 都 说 处 理 完 POST 请 求 后 一 定 要 重 定向 (https://en.wikipedia.org/ 
wiki/Post/Redirect/Get) ， 再 次 修改 针对 保存 POST 请 求 数 








据 的 单元 测试 ， 不 让 它 浑 染 包含 待 办 事项 的 响应 ， 而 是 重 定向 到 首页 : 




















保存 用 户 输 入 | 61 








lists/tests.py 


def test_home_page_can_save_a_POST_request(self): 
request = HttpRequest() 
request.method = 'POST' 
request.POST['item text'] = 'A new list item' 


response = home_page(request) 
self.assertEqual(Item.objects.count(), 1) 
New_item = Item.objects.first() 


self.assertEqual(new_item.text, 'A new list item') 


self.assertEqual(response.status_code, 302) 
self.assertEqual(response['location'], '/') 

















不 需要 再 拿 响应 中 的 .content 属性 值 和 渲染 模板 得 到 的 结果 比较 ， 因 此 把 相应 的 断言 删 掉 
了 。 现 在 ， 响 应 是 HTTP 重 定向 ， 状 态 码 是 302， 让 浏览 器 指向 一 个 新 地 址 。 








修改 之 后 运行 测试 ， 得 到 的 结果 是 2099 != 302 错误 。 现 在 可 以 大 幅度 清理 视图 函数 了 : 





lists/views.py(ch05/028) 


from django.shortcuts import redirect, render 
from lists.models import Item 


def home_page(request): 
if request.method == 'POST': 
Item.objects.create(text=request.POST['item text']) 
return redirect('/') 


return render(request, 'home.html') 
现在 ， 测试 应 该 可 以 通过 了 : 
Ran 5 tests in 0.010s 


OK 


更 好 的 单元 测试 实践 方法 : 一 个 测试 只 测试 一 件 事 

现在 视图 函数 处 理 完 POST 请 求 后 会 重 定向 ， 这 是 习惯 做 法 ， 而 且 单元 测试 也 一 定 程度 上 
缩短 了 ， 不 过 还 可 以 做 得 更 好 。 良 好 的 单元 测试 实践 方法 要 求 ， 一 个 测试 只 能 测试 一 件 
事 。 因 为 这 样 便于 查找 问题 。 如 果 一 个 测试 中 有 多 个 断言 ， 一 旦 前 面 的 断言 导致 测试 失 
败 ， 就 无 法 得 知 后 面 的 断言 情况 如 何 。 下 一 章 会 看 到 ， 如 果 不 小 心 破坏 了 视图 函数 ， 我 们 
想 知 道 到 底 是 保存 对 象 时 出 错 了 ， 还 是 响应 的 类 型 不 对 。 


刚 开始 可 能 无 法 写 出 只 有 一 个 断言 的 完美 单元 测试 ， 不 过 现在 似乎 是 把 正在 开发 的 功能 
开 测 试 的 好 机 会 : 

























































































lists/tests.py 
def test_ home page_can_save_a_POST_request(self): 
request = HttpRequest() 
request.method = “POST' 
request.POST['item text'] = 'A new list item' 
response = home_page(request) 
seLf .assertEquaL(Item.objects.count()，1) 


New_item = Item.objects.first() 
self.assertEqual(new_item.text, 'A new list item') 


def test home page_redirects after_POST(self): 
request = HttpRequest() 
request.method = “POST' 
request.POST['item text'] = 'A new list item' 
response = home_page(request) 


seLf .assertEquaL(response.status_code，302) 
self.assertEqual(response['location'], '/') 


现在 应 该 看 到 有 六 个 测试 通过 ， 而 不 是 五 个 : 
Ran 6 tests in 0.010s 


OK 


5.8 ”在 模板 中 泻 染 待 办 事项 


感觉 好 多 了 ! 再 看 待 办 事项 清单 。 

















4 


人 Ti 放 玉 条 -测定 二 -长 
。 在 表格 中 显示 多 个 待 办 事项 
。 支 持 多 个 清单 ! 








人 





AAA 








把 问题 从 清单 上 划 掉 几乎 和 看 着 测试 通过 一 样 让 人 满足 。 
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第 三 个 问题 是 最 后 一 个 容易 解决 的 问题 。 要 编写 一 个 新 单元 测试 ， 检 查 模板 是 否 也 能 显示 
多 个 待 办 、 











lists/tests.py 
class HomePageTest(TestCase) : 


Lisi] 
def test home page displays_all_ list items(self): 
Item.objects.create(text='itemey 1') 


Item.objects.create(text='itemey 2') 


request = HttpRequest() 
response = home_page(request) 


self.assertIn('itemey 1', response.content.decode()) 
self.assertIn('itemey 2', response.content.decode()) 


这 个 测试 和 预期 一 样 会 失败 : 





AssertionError: 'itemey 1' not found in '<html>\n <head>\n [...] 


Django 的 模板 句法 中 有 一 个 用 于 遍历 列表 的 标签 ， 即 {% for .in . 交 。 可 以 按照 下 面 
的 方式 使 用 这 个 标签 : 


lists/templates/home.html 
<table id="id_list_table"> 
{% for item in items %} 
<tr><td>1: {{ item.text }}</td></tr> 
{% endfor %} 
</table> 


~ 统 的 主要 优势 之 一 。 现 在 模板 会 演 染 多 个 <tr> 行 ， 每 一 行 对 应 items 变量 

一 个 元 素 。 这 么 写 很 优雅 ! 后 文 我 还 会 介绍 更 多 Django 模板 的 魔力 ， 但 总 有 一 天 你 
站 读 Django 文档 (https://docs.djangoproject.com/en/1.7/topics/templates/) , 学习 模 板 的 
其 他 用 法 。 


只 修改 模板 还 不 能 让 测试 通过 ， 还 要 在 首页 的 视图 中 把 待 办 事项 传 入 模板 : 























lists/views.py 
def home_page(request): 
if request.method == 'POST': 
Item.objects.create(text=request.POST['item text']) 
return redirect('/') 


items = Item.objects.all() 
return render(request, 'home.html', {'items': items}) 





这 样 单元 测试 就 能 通过 了 。 关 键 时 刻 到 了 ， 功 能 测试 能 通过 吗 ? 








$ python3 functional_tests.py 
[...] 


AssertionError: 'To-Do' not found in 'OperationalError at /' 


J 不 能 。 要 使 用 另 一 种 功能 测试 调试 技术 ， 也 是 最 直观 的 一 种 : 手动 访问 网 站 。 在 
| 览 器 中 打开 http://localhost:8000， 你 会 看 到 一 个 Django 调试 页 面 ， 提 示 “no such table: 
(没有 这 个 表 : lists_item) ， 如 图 5-2 所 示 。 





《 » localhost ( "@| 国 + as 


OperationalError at / 


no such table: lists_item 


Request Method: GET 
Request URL: http://localhost:8000/ 
Django Version: 1.6 
Exception Type: OperationalError 
Exception Value: no such table: lists item 
Exception Location: /usr/local/lib/python3.3/dist-packages/django/db/backends/sqlite3/base.py in execute, 
Python Executable: /usr/bin/python3 
Python Version: 3.3.2 
» ['/tmp/tmpdss633/superlists", 
Python Path: "/usr/Vocal/lib/python3.3/dist-packages/mock-1.0.1-py3.3.egg", 
"/usr/Vlib/python3.3", 
"/usr/lib/python3.3/plat-x86 64-linux-gnu", 
*/usr/lib/python3.3/Lib-dynload’ , 
/home/harry/.local/lib/python3.3/site-packages", 
"/usr/local/lib/python3.3/dist-packages", 
"/usr/Lib/python3/dist-packages'] 


Server time: Wed, 13 Nov 2013 13:13:13 +0000 


Error during template rendering 


In template /tmp/tmpdss633/superlists/lists/templates/home.html, error at line 13 


no such table: lists_item 


3 <title>To-Do lists</title> 








图 5-2: 又 一 个 很 有 帮助 的 调试 信息 


5.9 使 用 汪 移 创 汗 生 广 喀 所 库 


又 是 一 个 Django 生成 的 很 有 帮助 的 错误 消息 ， 大 意 是 说 没有 正确 设置 数据 库 。 你 可 能 会 
问 : fe Ee ee ”这 是 因为 Django 为 单元 测试 创建 了 专用 
的 测试 数据 库 一 一 这 是 Django 中 TestCase 所 做 的 神奇 事情 之 一 。 


为 了 设置 好 真正 的 数据 库 ， 要 创建 一 个 数据 库 。SQLite 数据 库 只 是 硬盘 中 的 一 个 文件 。 你 
会 在 Django 的 settings.py 文件 中 发 现 ， 默 认 情 况 下 ，Django 把 数据 库 保存 为 db.sqlite3， 
放 在 项 目的 基 目 录 中 : 

















superlists/settings.py 


[...] 
# Database 
# https://docs.djangoproject.com/en/1.7/ref/settings/#databases 
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DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), 


} 


我 们 已 经 在 models.py 文件 和 后 来 创建 的 迁移 文件 中 告诉 Django 创建 数据 库 所 需 的 一 切 信 
息 ， 为 了 创建 真正 的 数据 库 ， 要 使 用 Django 中 另 一 个 强大 的 manage.py 命令 














mtLgrate: 





$ python3 manage.py migrate 
Operations to perform: 
Synchronize unmigrated apps: contenttypes, sessions, admin, auth 
Apply all migrations: lists 
Synchronizing apps without migrations: 
Creating tables... 
Creating table django_admin_ log 
Creating table auth_permission 
Creating table auth group_permissions 
Creating table auth_group 
Creating table auth_user_groups 
Creating table auth user_user_permissions 
Creating table auth_user 
Creating table django_content_type 
Creating table django_session 
Installing custom SQL... 
Installing indexes... 
Running migrations: 
Applying lists.0001 initial... OK 
Applying lists.0002_ item text... OK 


You have installed Django's auth system, and don't have any superusers defined. 
Would you like to create one now? (yes/no): 
no 





关于 超级 用 户 的 问题 我 的 回答 是 “no”， 因 为 现在 还 不 需要 ， 但 后 面 的 章节 会 用 到 。 现 在 ， 
可 以 刷新 localhost 上 的 页 面 了 ， 你 会 发 现 错误 页 面 不 见 了 “。 然 后 再 运行 功能 测试 试 试 : 


Ba 









































AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers', '1: Use peacock feathers to make a fly'] 


快 成 功 了 ， 只 需要 让 清单 显示 正确 的 序号 即 可 。 另 一 个 出 色 的 Django 模板 标签 forloop. 
counter 能 帮助 解决 这 个 问题 : 





lists/templates/home.html 


{% for item in items %} 
<tr><td>{{ forloop.counter }}: {{ item.text }}</td></tr> 
{% endfor %} 




















注 3: 如 果 你 看 到 了 另 一 个 错误 页 面 ,重启 开发 服务 器 试 试 。Django 可 能 被 发 生 在 眼皮 子 底下 的 事情 搞 糊涂 了 。 












































再 试 一 次 ， 应 该 会 看 到 功能 测试 运行 到 最 后 了 : 


sel 
Asserti 


f.fail('Finish the test!') 
onError: Finish the test! 


不 过 运行 测试 时 ， 你 可 能 会 注意 到 有 什么 地 方 不 对 劲 ， 如 图 5-3 所 示 。 





loc 


@ x 


Enter a to-dt 


To-Do lists - Mozilla Firefox 


图 Google QD 电信 国 v *v XK 


alhost YG 


FirefoxY ” 轩 态 -Dolists [+ | 





Your To-Do list 


item 


1: Buy peacock feathers 
2: Use peacock feathers to make a fly 
3: Buy peacock feathers 
4: Use peacock feathers to make a fly 


S98 














5-3; 有 上 一 


待 办 事项 又 多 了 : 


Buy 
Use 
Buy 
Use 
Buy 
Use 


OUWUPOWODPP 





$ rm db. 


$ pytho 














peacock feathers 
peacock feathers to make a fly 
peacock feathers 
peacock feathers to make a fly 
peacock feathers 
peacock feathers to make a fly 


啊 ， 离 成 功 就 差 一 点 点 了 。 需 要 一 种 自动 清理 
库 再 执行 migrate 命令 新 建 : 





sqlite3 
n3 manage.py migrate --noinput 


清理 之 后 要 确保 功能 测试 仍 能 通过 








J 
| 


次 运行 测试 时 遗留 下 来 的 待 办 事项 
我 ， 天 呐 。 看 起 来 上 一 次 运行 测试 时 在 数据 库 中 遗留 了 数据 。 如 果 再 次 运行 测试 ， 会 发 现 
































EE 机制 。 你 可 以 手动 清理 ， 方 法 是 先 删除 数据 








保存 
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除了 功能 测试 中 这 个 小 问题 之 外 ， 我 们 的 代码 基本 上 都 可 以 正常 运行 了 。 下 面 做 一 次 提 


交 吧 。 











先 执 行 git status， 再 执行 git diff， 你 应 该 会 看 到 对 home.html、tests.py 和 views.py 所 
做 的 改动 。 然 后 提交 这 些 改 动 : 








$ git add lists 
$ git commit -m"Redirect after POST, and show all items in template" 





你 可 能 会 觉得 在 每 一 章 结束 时 做 个 标记 很 有 用 ， 例 如 在 本 章 结束 时 可 以 这 么 
做 : git tag end-of-chapter-05。 





这 一 章 我 们 做 了 什么 呢 ? 


。 编写 了 一 个 表单 ， 使 用 POST 请 求 把 新 待 办 事项 添加 到 清单 中 ， 
。 创建 了 一 个 简单 的 数据 库 模 型 ， 用 来 存储 待 办 事项 ， 
。 使 用 了 至 少 三 种 功能 测试 调试 技术 。 


但 在 待 办 事项 清单 中 也 有 几 个 条 目 ， 其 中 一 项 是 “功能 测试 运行 完毕 后 清理 “， 还 有 一 项 
或 许 更 紧急 一 一 “支持 多 个 清单 ”。 


我 想 说 的 是 ， 虽 然 网 站 现在 这 个 样子 可 以 发 布 ， 但 用 户 可 能 会 觉得 奇怪 : 为 什么 所 有 人 要 
共用 一 个 待 办 事项 清单 。 我 想 这 会 让 人 们 停 下 来 思考 一 些 问题 : 我 们 彼此 之 间 有 怎样 的 联 
系 ， 在 地 球 这 艘 宇宙 飞船 上 有 着 怎样 的 共同 命运 ， 要 如 何 团结 起 来 解决 共同 面 对 的 全 球 性 
问 题 o 
































可 实际 上 ， 这 个 网 站 还 没什么 用 。 


先 这 样 吧 。 











有 用 的 TDD 概念 
回归 
新 添加 的 代码 破坏 了 应 用 原本 可 以 正常 使 用 的 功能 。 


意外 失败 
测试 在 意料 之 外 失败 了 。 这 意味 着 测试 中 有 错误 ， 或 者 测试 帮 我 们 发 现 了 一 个 回 
归 ， 因 此 要 在 代码 中 修正 。 


遇 红 / 变 绿 / 重 构 
描述 TDD 流程 的 另 一 种 方式 。 先 编写 一 个 测试 看 着 它 失败 ( 遇 红 )， 然 后 编写 代码 
让 测试 通过 ( 变 绿 ) ， 最 后 重 构 ， 改 进 实 现 方式 。 


三 角 法 

添加 一 个 测试 ， 专 门 为 某 些 现 有 的 代码 编写 用 例 ， 以 此 推断 出 普 适 的 实现 方式 (在 
此 之 前 的 实现 方式 可 能 作 产 了 ) 。 

事 不 过 三 , 三 则 重 构 

判断 何 时 删除 重复 代码 时 使 用 的 经 验 法 则 。 如 果 两 段 代码 很 相似 ， 往 往 还 要 等 到 第 
三 段 相似 代码 出 现 ， 才 能 确定 重 构 时 哪 一 部 分 是 真正 共通 、 可 重用 的 。 

记 在 便签 上 的 待 办 事项 清单 

在 便签 上 记录 编写 代码 过 程 中 遇 到 的 问题 ， 等 手头 的 工作 完成 后 再 回 过 头 来 解决 。 
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本 章 要 解决 前 一 章 结束 时 发 现 的 问题 。 首 先是 功能 测试 运行 结束 后 的 清理 。 其 次 是 较 一 般 
的 问题 ， 即 我 们 的 设计 目前 只 允许 创建 一 个 全 球 共用 的 清单 。 我 会 演示 一 个 关键 的 TDD 
技术 : 如 何 使 用 递增 的 步 进 式 方法 修改 现 有 代码 ， 而 且 保证 修改 前 后 代码 都 能 正常 运行 。 
我 们 要 做 测试 山羊 ， 而 不 是 重 构 猫 。 


全 E 省、 十 -下 豆 ST 
6.1 确保 功能 测试 之 间 相互 隔离 
前 一 音 结 束 时 留 下 了 一 个 典型 的 测试 问题 : 如 何 隔离 测试 。 运 行 功能 测试 后 待 办 事项 一 直 
存在 于 数据 库 中 ， 这 会 影响 下 次 测试 的 结果 。 
运行 单元 测试 时 ，Django 的 测试 运行 程序 会 自动 创建 一 个 全 新 的 测试 数据 库 (和 应 用 真正 
使 用 的 数据 库 不 同 )， 运 行 每 个 测试 之 前 都 会 清空 数据 库 ， 等 所 有 测试 都 运行 完 之 后 ， 再 
删除 这 个 数据 库 。 但 是 功能 测试 目前 使 用 的 是 应 用 真正 使 用 的 数据 库 db.sqlite3。 


这 个 问题 的 解决 方法 之 一 是 自己 动手 ， 在 functional_tests.py 中 添加 执行 清理 任务 的 代码 。 
这 样 的 任务 最 适合 在 setup 和 tearDown 方法 中 完成 。 
























































不 过 从 1.4 版 开始 ，Django 提供 的 一 个 新 类 ，LiveserverTestCase， 它 可 以 代 我 们 完成 这 
一 任务 。 这 个 类 会 自动 创建 一 个 测试 数据 库 〈 跟 单元 测试 一 样 )， 并 局 动 一 个 开发 服务 器 ， 
让 功能 测试 在 其 中 运行 。 虽 然 这 个 工具 有 一 定局 限 性 〈 稍 后 解决 )， 不 过 在 现 阶段 十 分 有 
用 。 下 面 学 习 如 何 使 用 。 


下 
和 






































LiveServerTestCase 必须 使 用 Imanage.py， 由 Django 的 闹 试 运 行程 序 运 和 。 从 Django 1.6 
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开始 ， 测 试 运行 程序 查找 所 有 名 字 以 test 开头 的 文件 。 为 了 保持 文件 结构 清晰 ， 要 新 建 一 
个 文件 夹 保 存 功 能 测试 ， 让 它 看 起 来 就 像 一 个 应 用 。Django 对 这 个 文件 夹 的 要 求 只 
必须 是 有 效 的 Python 模块 ， 即 文件 夹 中 要 有 一 个 _init_.py 文件 。 











$ mkdir functional_tests 
$ touch functional_tests/_ init_ .py 


然后 要 移动 功能 测试 ， 把 独立 的 functional -tests 了 y 文件 移 到 functional_tests 应 用 中 ， 并 
把 它 重 命名 为 tests.py。 使 用 git mv 命令 完成 这 个 操作 ， 让 Git 知道 文件 移动 了 : 


$ git mv functional_tests.py functional_tests/tests.py 
$ git status # 显示 文件 重 命名 为 functional_tests/tests.py, 而 且 新 增 了 __init__.py 


现在 的 目录 结果 如 下 所 示 : 














FF” db.sqLite3 

一 functional_tests 

| FE _init .py 

| LL tests.py 

| 一 Lists 

一 admin.py 

HF _init_.py 

HF migrations 

FF 一 0001_initial.py 
一 0002_item_text.py 
FF 一 init .py 
[一 pycache_ 
一 modeLs.py 

| 一 pycache_ 

| 一 tempLates 

上 -一 home .htmL 
一 tests.py 

-一 views.py 

manage .py 

superlists 

H 一 _init .py 

一 pycache_ 

一 settings.py 

HF urLs.py 


[一 wsgi.py 





[TT 


functional tests.py 不 见 了 ， 变 成 了 functional_tests/tests.py。 现 在 ， 运 行 功能 测试 不 执行 python3 
function al_tests.py 命令 ， 而 是 使 用 python3 manage.py test functional_tests 命令 。 











功能 测试 可 以 和 tists 应 用 测试 混在 一 起 ， 不 过 我 喜欢 把 两 种 测试 分 开 ， 基 
为 功能 测试 检测 的 功能 往往 存在 不 同 应 用 中 。 功 能 测试 以 用 户 的 视角 看 待 二 
物 ， 而 用 户 并 不 关心 你 如 何 把 网 站 分 成 不 同 的 应 用 。 














Bl 








接 下 来 编辑 functional_tests/tests.py， 修 改 NewVisitorTest 类 ， 让 它 使 用 LiveServerTestCase: 
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functional tests/tests.py (c1061007) 


from django.test import LiveServerTestCase 
from selenium import webdriver 
from selenium.webdriver.common.keys import Keys 


class NewVisitorTest(LiveServerTestCase): 


def setUp(self): 
| | 


继续 往 下 修改 '。 访 问 网 站 时 ， 不 用 硬 编码 的 本 地 地 址 (localhost:8000)， 可 以 使 用 


LiveServerTestCase 提供 的 live_server_url 属性 : 


functional tests/tests.py (ch061002) 
def test can_start a_ list and_retrieve it later(self): 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 


seLf .browser .get(seLf.Live_server_UrL) 
































还 可 以 删除 文件 末尾 的 if _nane == "main 代码 块 ， 因 为 之 后 都 使 用 Django 的 测 
试 运行 程序 运行 功能 测试 。 














现在 能 使 用 Django 的 测试 运行 程序 运行 功能 测试 了 ， 指 明 只 运行 functional_tests 应 用 
中 的 测试 : 


功能 





$ python3 manage.py test functional_tests 
Creating test database for alias 'default'... 


FAIL: test can_start a_list and_retrieve it later 
(functional_tests. tests.NewVisitorTest) 
Traceback (most recent call last): 
File "/workspace/superlists/functional_tests/tests.py", line 61, in 
test_can_start a_list _and_retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 


Ran 1 test in 6.378s 


FAILED (failures=1) 
Destroying test database for alias 'default'... 











测试 和 重 构 前 一 样 ， 能 运行 到 self.fail。 如 果 再 次 运行 测试 ， 你 会 发 现 ， 之 前 的 测 

















试 不 再 遗留 待 办 事项 了 ， 因 为 功能 测试 运行 完 之 后 把 它们 清理 掉 了 。 成 功 了 ， 现 在 应 该 提 
交 这 次 小 改动 : 























: 你 是 不 是 没有 继续 修改 , 想 知 道 某 些 代码 清单 旁边 的 ch0610xx 是 什么 意思 ? 它们 表示 本 书 示例 仓库 中 的 
某 次 提交 (https://github.com/hjwp/book-example/commits/chapter_06)。 这 个 字符 串 只 与 书 中 内 容 的 正确 性 
测试 有 关 。 我 偶尔 会 为 某 些 测试 编写 测试 ， 检 查 这 本 讲解 测试 的 书 其 中 的 测试 是 否 正 确 。 




















$ git status # 重 命名 并 修改 了 functional_tests.py, 新 增 了 __iinit__.py 

$ git add functional_tests 

$ git diff --staged -M 

$ git commit # 提交 消息 举例 :"make functional_tests an app, use LiveServerTestCase" 


git diff 命令 中 的 -M 标 志 很 有 和 用， 意思 是 “检测 移动 "， 所 以 git 会 注意 到 functional_tests. 
py 和 functional_tests/tests.py 是 同一 个 文件 ， 显 示 更 合理 的 差异 (去掉 这 个 旗 标 试 试 )。 




















只 运行 单元 测试 
现在 ， 如 果 执行 nanage.py test 命令 ，Django 会 运行 功能 测试 和 单元 测试 : 


$ python3 manage.py test 
Creating test database for alias 'default'... 


FAIL: test can_start _a_list _and_retrieve it later 


[...] 


AssertionError: Finish the test! 


Ran 8 tests in 3.132s 


FAILED (failures=1) 
Destroying test database for alias 'default'... 








如 果 只 想 运 行 单元 测试 ， 可 以 指定 只 运行 lists 应 用 中 的 测试 





$ python3 manage.py test lists 
Creating test database for alias 'default'... 


Ran 7 tests in 0.009s 


OK 
Destroying test database for alias 'default'... 





有 用 的 命令 (更 新 版 ) 
。 运行 功能 测试 
python3 manage.py test functional_tests 
。 运行 单元 测试 
python3 manage.py test lists 
如 果 我 说 “运行 测试 ”， 而 你 不 确定 我 指 的 是 哪 一 种 测试 怎么 办 ? 可 以 回顾 一 下 第 4 章 


最 后 一 节 中 的 流程 图 ， 试 着 找 出 我 们 处 在 哪 一 步 。 通 常 只 在 所 有 单元 测试 都 通过 后 才 
会 运行 功能 测试 。 如 果 不 清 楚 ， 两 种 测试 都 运行 试 试 吧 ! 
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现在 ， 思 考 如 何 支 持 多 个 清单 。 目 前 ， 功 能 测试 《和 设计 文档 最 接近 ) 是 这 么 写 的 : 








functional tests/tests.py 


# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
# 她 看 到 网 站 为 她 生成 了 一 个 唯一 的 URL 

# 而 且 页 面 中 有 一 些 文字 解说 这 个 功能 
self.fail('Finish the test!') 

















# 她 访问 那个 URL ,发 现 她 的 待 办 事项 清单 还 在 





# 她 很 满意 ,去 睡觉 了 


其 实 真正 想 表 达 的 意思 是 ， 一 个 用 户 不 能 查看 另 一 个 用 户 的 清单 ， 而 且 每 个 清单 都 有 自己 
的 URL， 以 便 访 问 保存 的 清单 。 还 要 多 想 想 怎 么 实现 这 个 功能 。 


6.2 ”必要 时 做 少量 的 设计 

TDD 和 软件 开发 中 的 敏捷 运动 联系 紧密 。 敏 捷 运动 反对 传统 软件 工程 实践 中 “预先 做 大 量 
设计 ”的 做 法 ， 因 为 除了 要 花费 大 量 时 间 收 集 需求 之 外 ， 设 计 阶段 还 要 用 等 量 的 时 间 在 纸 
上 规划 软件 。 敏 捷 理念 则 认为 ， 在 实践 中 解决 问题 比 理论 分 析 能 学 到 更 多 ， 而 且 让 应 用 尽 
早 接 受 真 实用 户 的 检验 效果 更 好 。 无 需 花 这 么 多 时 间 提 前 设计 ， 而 要 尽早 把 最 简 可 用 的 应 
用 放出 来 ， 根 据 实际 使 用 中 得 到 的 反馈 逐步 向 前 推进 设计 。 


















































这 并 不 是 说 要 完全 禁止 思考 设计 。 前 一 章 我 们 看 到 ， 不 经 思考 呆 头 呆 脑 往 前 走 ， 最 终 也 能 
找到 正确 答案 ， 不 过 稍微 思考 一 下 设计 往往 能 帮助 我 们 更 快 地 找到 答案 。 那 么 ， 下 面 分 析 
一 下 这 个 最 简 可 用 的 应 用 ， 想 想 应 该 使 用 哪 种 设计 方式 。 


。 想 让 每 个 用 户 都 能 保存 自己 的 清单 ， 目 前 来 说 ， 至 少 能 保存 一 个 清单 。 

。 清单 由 多 个 待 办 事项 组 成 ， 待 办 事项 的 主要 属性 应 该 是 一 些 描述 性 文字 。 

。 要 保存 清单 , 以 便 多 次 访问 。 现 在 ,可 以 为 用 户 提供 一 个 唯一 的 URL, 指向 他 们 的 清单 。 
以 后 或 许 需 要 一 种 自动 识别 用 户 的 机 制 ， 然 后 把 他 们 的 清单 显示 出 来 。 


为 了 实现 第 一 条 ， 看 样子 要 把 清单 和 其 中 的 待 办 事项 存 和 人 数据库。 每 个 清单 都 有 一 个 唯一 
的 URL， 而 且 清单 中 的 每 个 待 办 事项 都 是 一 些 描述 性 文字 ， 和 所 在 的 清单 关联 。 































































































6.2.1 YAGNI 

关于 设计 的 思考 一 旦 开始 就 很 难 停 下 来 ， 我 们 会 冒 出 各 种 想法 : 或 许 想 给 每 个 清单 起 个 
名 字 或 加 个 标题 ， 或 许 想 使 用 用 户 名 和 密码 识别 用 户 ， 或 许 想 给 清单 添加 一 个 较 长 的 备 
注 和 简短 的 描述 ， 或 许 想 存储 某 种 顺序 ， 等 等 。 但 是 ， 
“YAGNI”( 读 作 yag-knee)。 它 是 “You aint gonna need it” 的 简称 (“你 不 需要 这 个 ”)。 作 
为 软件 开发 者 ， 我 们 从 创造 事物 中 获得 乐趣 。 有 了 时 我 们 冒 出 一 个 想法 ， ee 便 

















无 法 抵御 内 心 的 冲动 想 要 开发 出 来 。 可 问题 是 ， 不 管 想法 有 多 好 ， 大 多 数 情况 下 最 终 你 都 
用 不 到 这 个 功能 。 应 用 中 会 残留 很 多 没 用 的 代码 ， 还 增加 了 应 用 的 复杂 度 。YAGNI 是 个 
真言 ， 可 以 用 来 抵御 热切 的 创造 欲 。 














6.2.2 REST 


我 们 已 经 知道 怎么 处 理 数据 结构 ， 即 使 用 “模型 - 视图 - 控制 器 ”中 的 模型 部 分 。 那 视图 
和 控制 器 部 分 怎么 办 呢 ? 在 Web 浏览 器 中 用 户 怎么 处 理 清 单 和 待 办 事项 呢 ? 
































“表现 层 状态 转化 ”(Representational State Transfer，REST) 是 Web 设计 的 一 种 方式 ， 经 
常用 来 引导 基于 Web 的 API 设计 。 设 计 面 向 用 户 的 网 站 时 ， 不 必 严 格 遵守 REST 规则 ， 
可 是 从 中 能 得 到 一 些 启发 。 




















REST 建议 URL 结构 匹配 数据 结构 ， 即 这 个 应 用 中 的 清单 和 其 中 的 待 办 事项 。 清 单 有 各 自 的 URL: 








/lists/<list identifier>/ 


这 个 URL 满足 了 功能 测试 中 提出 的 需求 。 若 想 查 看 某 个 清单 ， 我 们 可 以 发 送 一 个 GET 请 
求 ( 就 是 在 普通 的 浏览 器 中 访问 这 个 页 面 )。 





若 想 创 建 全 新 的 清单 ， 可 以 向 一 个 特殊 的 URL 发 送 POST 请 求 : 
/Lists/new 

若 想 在 现 有 的 清单 中 添加 一 个 新 待 办 事项 ， 我 们 可 以 向 另外 一 个 URL 发 送 POST 请 求 : 
/Lists/<List identifier>/add_item 


(再 次 说 明 ， 我 们 不 会 严格 遵守 REST 制定 的 规则 ， 只 是 从 中 得 到 启发 一 一 这 里 我 们 要 使 
用 PUT 请 求 。) 








概括 起 来 ， 本 章 的 便签 如 下 所 示 : 








。-9 能 训 试 运行 完 举 后 请 理 

。 调 整 模型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 

。 为 条 个 清单 添加 叭 一 的 URL 

。 添 加 通过 POST 请 求 新 建 清单 所 需 的 URL 

。 添 加 通过 POST 请 求 在 现 少 的 清单 中 增加 新 待 办 事项 所 需 的 URL 


A A A > ni 


WW 呈 呈 





| A > “ 
i wy i 
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6.3 使 用 TDD 实 现 新 设计 


应 该 如 何 使 用 TDD 实现 新 的 设计 呢 ? 再 回顾 一 下 TDD 的 流程 图 ， 如 图 6-1 所 示 。 





























怎 行 功能 测试 。 型 应 用 是 否 
是 否 通过 ? 需要 重 构 ? 











有 本 于 i 应 用 是 否 、 
ee 需要 重 构 ? 





“单元 测试 /编写 代码 ”循环 











图 6-1: 包含 功能 测试 和 单元 测试 的 TDD 流程 


























在 流程 的 外 层 ， 既 要 添加 新 功能 (扩展 功能 测试 ， 再 编写 新 的 应 用 代码 ) ， 也 要 重 构 应 用 
的 代码 ， 即 重 写 部 分 现 有 的 实现 ， 保 持 应 用 的 功能 不 变 ， 但 使 用 新 的 设计 方式 。 在 单元 测 











试 层 ， 要 添加 新 测试 或 者 修改 现 有 的 测试 ， 检 查 想 改动 的 功能 ， 没 改动 的 测试 则 
这 个 过 程 没 有 破坏 现 有 的 功能 。 
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式 修改 随后 的 代码 : 


下 面 根据 便签 上 的 待 办 事项 编写 功能 测试 。 伊 迪 丝 提交 第 一 个 待 办 事项 后 ， 我 们 希望 应 
创建 一 个 新 清单 ， 并 在 这 个 清单 中 添加 一 个 待 办 事项 ， 然 后 把 她 带 到 显示 这 个 清单 的 
而 。 在 功能 测试 中 找到 inputbox.send_keys('Buy peacock feathers')， 然 后 按照 下 面 的 方 








来 保证 


汉 弄 














functional tests/tests.py 


inputbox.send_keys('Buy peacock feathers') 


# 她 按 回 车 键 后 ,被 带 到 了 一 个 新 URL 

# 这 个 页 面 的 待 办 事项 清单 中 显示 了 “1: Buy peacock feathers” 
inputbox.send_keys(Keys.ENTER) 

edith list url = self.browser.current_url 
self.assertRegex(edith list url, '/lists/.+') #0 
self.check_for_row_in list table('1: Buy peacock feathers') 
































# 页 面 中 有 显示 了 一 个 文本 框 ,可 以 输入 其 他 的 待 办 事项 
Ei] 














@ assertRegex 是 unittest 中 的 一 个 辅助 函数 ， 位 窜 字符 旧 龙 是 否 和 正则 表达 式 匹配 。 我 们 
使 用 这 个 方法 检查 是 否 实现 了 新 的 REST 式 设计 。 这 个 方法 的 具体 用 法 参阅 unittest 
的 文档 (https://docs.python.org/3/library/unittest.html) 。 


还 要 修改 功能 测试 的 结尾 部 分 ， 假设 有 一 个 新 用 户 正在 访问 网 站 。 这 个 新 用 户 访 问 首页 
时 ， 要 测试 他 不 外 外 到 伊 迪 的 待 办 事项 ， 而 且 他 的 清单 有 自己 的 唯一 URL。 


从 self.fail 之 前 的 注释 (“ 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 ”这 行 ) 开始 ， 把 
随后 的 内 容 都 删 掉 ， 替 换 成 下 述 功能 测试 的 新 结尾 








functional tests/tests.py 


[sa 

# 页 面 再 次 更 新 ,她 的 清单 中 显示 了 这 两 个 待 办 事项 
seLf.check_for_row_in_List_tabLe('2: Use peacock feathers to make a fly') 
self.check_for_row_in list table('1: Buy peacock feathers ' ) 





























# 现在 一 个 叫 作 弗朗西斯 的 新 用 户 访问 了 网 站 


## 我 们 使 用 一 个 新 浏览 器 会 话 

天 确保 伊 迪 丝 的 信息 不 会 从 cookie 中 泄露 出 来 #@ 
seLf .browser .quit() 

seLf .browser = webdriver.Firefox() 



































# 弗朗西斯 访问 首页 

# 页 面 中 看 不 到 伊 迪 丝 的 清单 

seLf .browser .get(seLf.Live_server_UrL) 

page_text = seLf.browser .find_eLement_by_tag_name('body ' ) .text 
seLf .assertNotIn( "Buy peacock feathers', page_text) 

seLf .assertNotIn('make a fly', page_text) 


























# 弗朗西斯 输入 一 个 新 待 办 事项 ,新 建 一 个 清单 

# 他 不 像 伊 迪 丝 那样 兴趣 嚼 然 

inputbox = self.browser.find element by_id('id new_item') 
inputbox.send_keys('Buy milk') 
inputbox.send_keys(Keys.ENTER) 





# 弗朗西斯 获得 了 他 的 唯一 URL 


francis_list _ url = self.browser.current_url 
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self.assertRegex(francis list url, '/lists/.+') 
self.assertNotEqual(francis_list_url, edith_ list_url) 


# 这 个 页 面 还 是 没有 伊 迪 丝 的 清单 

page_text = self.browser.find element_ by_tag_name('body').text 
self.assertNotIn('Buy peacock feathers', page_text) 
seLf.assertIn('Buy milk', page_text) 


# 两 人 都 很 满意 ,去 睡觉 了 

@ 按照 习惯 ,我 使 用 两 个 # 号 表示 “元 注释 ”。 元 注释 的 作用 是 说 明 测 试 的 工作 方式 ， 以 
及 为 什么 这 么 做 。 使 用 两 个 井 号 是 为 了 和 功能 测试 中 解说 用 户 故事 的 常规 注释 区 分 开 。 
这 个 元 注释 是 发 给 未 来 的 自己 的 消息 ， 如 果 没 有 这 个 消息 ， 到 时 你 可 能 会 觉得 奇怪 ， 想 
知道 到 底 为 什么 要 退出 浏览 器 再 启动 一 个 新 会 话 。 











除了 元 注释 之 外 ， 其 他 改动 基本 不 用 多 做 解释 。 我 们 看 一 下 运行 功能 测试 后 的 情况 如 何 : 


AssertionError: Regex didn't match: '/lists/.+' not found in 
'http://Llocalhost:8081/" 





出 现 这 个 错误 在 意料 之 中 。 先 提交 一 次 ， 然 后 再 编写 一 些 新 模型 和 新 视图 : 





$ git commit -a 


今天 我 运行 功能 测试 时 ， 发 现 它 一 直 停 滞 不 前 。 原 来 是 因为 我 需要 升级 
Selenium 了 。 升 级 的 方法 是 执行 pip3 install --upgrade seleniun 命令 。 你 
可 能 还 记得 在 序 中 说 过 ， 安 装 最 新 版 的 Selenium 是 很 重要 的 。 我 上 次 更 新 后 
还 没 过 几 个 月 ，Selenium 的 小 版 本 号 就 比 之 前 增加 了 6。 如 果 你 遇 到 了 诡异 
的 问题 一定 要 升级 Selenium 试 试 ! 

















6.4 ”逐步 迭代 ， 实 现 新 设计 

我 太 兴 奋 了 ， 迫 切 地 想 实现 新 设计 ， 这 个 欲望 太 强 烈 ， 谁 也 无 法 阻拦 ， 我 真 想 现 在 就 开 
始 修改 models.py。 但 这 么 做 可 能 会 导致 一 半 的 单元 测试 失败 ， 我 们 不 得 不 一 行 一 行 修改 
代码 ， 而 且 要 一 次 改 完 ， 工 作 量 太 大 。 有 这 样 的 冲动 很 自然 ,但 TDD 理念 一 直 反 对 这 么 
做 。 我 们 要 遵从 测试 山羊 的 教诲 ， 不 能 听信 测试 猫 的 次 言 。 无 需 一 次 性 实现 光鲜 亮丽 的 
整个 设计 ， 改 动 的 幅度 要 小 一 些 ， 每 一 步 都 要 遵照 设计 思想 的 指引 ， 保 证 修改 后 应 用 仍 
能 正常 运行 。 




















在 待 办 事项 清单 中 还 有 四 个 问题 没 解决 。 无 法 匹配 正则 表达 式 的 那个 功能 测试 提醒 我 们 ， 
接 下 来 要 解决 的 是 第 二 个 问题 ， 即 为 每 个 清单 添加 唯一 的 URL 和 标识 符 。 下 面 解决 且 只 


解决 这 个 问题 。 








清单 的 URL 出 现在 重 定向 POST 请 求 之 后 。 在 文件 lists/tests.py 中 ， 找 到 test_home_page_ 
redirects_after_P0ST， 修 改 重 定向 期 望 转向 的 地 址 : 





lists/tests.py 


self.assertEqual(response.status_code, 302) 
self.assertEqual(response['location'], '/lists/the-only-list-in-the-world/') 


这 个 URL 看 起 来 是 不 是 有 点 儿 奇 怪 ? 在 应 用 的 最 终 设 计 中 显然 不 会 使 用 /lists/the-only-list-in-the- 
world/ 这 个 URL。 可 是 我 们 承诺 过 ， 一 次 只 做 一 项 改动 ， 既 然 应 用 现在 只 支持 一 个 清单 ， 那 这 
就 是 唯一 合理 的 URL。 我 们 还 在 向 前 进 ， 到 时 候 清 单 和 首页 的 地 址 都 会 变 ， 这 是 更 符合 REST 
式 设计 的 一 个 实现 步骤 。 稍 后 我 们 会 支持 多 个 清单 ， 也 会 提供 简单 的 方法 修改 URL。 























运行 单元 测试 ,会 看 到 一 














我 们 可 以 换 种 想法 ， 把 这 看 成 是 一 种 解决 问题 的 技术 : 新 的 URL 设计 还 没 
实现 ， 所 以 这 个 URL 可 用 于 没有 待 办 事项 的 清单 。 最 终 要 设法 解决 包含 
个 待 办 事项 的 清单 ， 不 过 解决 包含 一 个 待 办 事项 的 清单 是 个 好 的 开始 。 























个 预期 失败 : 


$ python3 manage.py test lists 


[...] 


AssertionError: '/' != '/lists/the-only-list-in-the-world/' 


可 以 修改 文件 lists/views.py 中 的 home_page 视 








器 








lists/views.py 


def home_page(request): 
if request.method == 'POST': 
Item.objects.create(text=request.POST['item text']) 
return redirect('/lists/the-only-list-in-the-world/') 


items = Item.objects.all() 
return render(request, 'home.html', {'items': items}) 


这 么 修改 ， 功 能 测试 显 
测试 ， 你 会 看 到 测试 在 党 








然 会 失败 ， 因 为 网 站 中 并 没有 这 个 URL。 毫 无 疑问 ， 如 果 运 行 功 能 





试 提交 第 一 个 待 办 事项 后 失败 ， 提 示 无 法 找到 显示 清单 的 表格 。 


出 现 这 个 错误 的 原因 是 ，/the-only-list-in-the-world/ 这 个 URL 还 不 存在 。 


self.check_for_row_ in list table('1: Buy peacock feathers') 


Las] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id_ list table"}' ; Stacktrace: 


那么 ， 接 下 来 就 为 这 个 唯一 的 清单 提供 一 个 特殊 的 URL 吧 。 
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6.5 ”使 用 Django 测 试 客户 端 一 起 测试 视图 、 模 板 
和 和 URL 


在 前 面 儿童 中 ， 使 用 单元 测试 检查 是 否 能 解析 URL， 也 调用 了 视图 函数 检查 它们 是 否 能 
常 使 用 ， 还 检查 了 视图 能 否 正 确 泻 染 模板 。 其 实 ，Django 提供 了 一 个 小 工具 ， 可 以 一 次 完 
成 这 三 种 测试 。 本 市 我 们 就 要 使 用 这 个 工具 。 
































我 先 告诉 你 如 何 自己 实现 ， 部 分 原因 是 这 么 做 能 更 好 地 介绍 Django 的 工作 方式 。 而 且 我 
介绍 的 技术 可 移植 ， 因 为 你 不 可 能 一 直 使 用 Django， 但 差不多 总 会 用 到 视图 函数 、 模 板 和 
URL 映射 ， 到 时 你 就 知道 如 何 测 试 了 。 


6.5.1 一 个 新 测试 类 

下 面 使 用 Django 测试 客户 端 。 打 开 lists/tests.py， 添 加 一 个 新 测试 类 ,命名 为 ListViewTest。 
然后 把 HomePageTest 类 中 的 test_home_page_displays_all_list itenms 方法 复制 到 这 个 讲 
类 中 。 重 新 命名 这 个 方法 ， 再 做 些 修 改 : 





lists/tests.py (ch061009) 


class ListViewTest(TestCase): 
def test displays all items(self): 
Item.objects.create(text='itemey 1') 
Item.objects.create(text='itemey 2') 


response = self.client.get('/lists/the-only-list-in-the-world/') #©@ 


self.assertContains(response, 'itemey 1') #@ 
self.assertContains(response, 'itemey 2') #@ 





@ 现在 不 用 直接 调用 视图 函数 了 ， 使 用 Django 测试 客户 端 。 测 试 客户 端 是 Django 中 
TestCase 类 的 一 个 属性 ， 名 为 self.client。 告 诉 测 试 客户 端 ， 使 用 GET 请 求 (.get) 
访问 要 测试 的 URL 一 一 其 实 这 和 Selenium 使 用 的 API 非常 类 似 。 


























@ 日 现在 不 必 再 使 用 有 点 儿 烦 人 的 assertIn 和 response.content.decode() 了 ，Django 提 
供 了 assertContains 方法 ， 它 知道 如 何 处 理 响 应 以 及 响应 内 容 中 的 字 节 。 




















有 些 人 并 不 喜欢 Django 测试 客户 端 。 这 些 人 说 ， 测 试 客户 端 隐藏 了 太 多 细 
节 ， 而 且 牵涉 了 太 多 本 该 在 真正 的 单元 测试 中 使 用 的 组 件 ， 因 此 最 终 写 成 的 
测试 叫 整合 测试 更 合适 。 他 们 还 抱怨 ， 使 用 测试 客户 端的 测试 运行 太 慢 (以 
毫秒 计 )。 后 面 的 章节 会 进一步 分 析 这 个 争论。 现在 使 用 测试 客户 端 ， 是 因 
为 它 用 起 来 十 分 方便 。 












































尝试 运行 这 个 测试 : 
AssertionError: 404 != 200 : Couldn't retrieve content: Response code was 404 


6.5.2 一 个 新 URL 
现在 那个 唯一 的 清单 URL 还 不 存在 ， 要 在 superlists/urls.py 中 解决 这 个 问题 。 




















留意 URL 末尾 的 斜 线 ， 在 测试 中 和 urls.py 中 都 要 小 心 ， 因 为 这 个 斜 线 往往 
就 是 问题 的 根源 。 











superlists/urls.py 
urlpatterns = patterns('', 
url(r'^$', 'lists.views.home_ page', name='home'), 
url(r'^lists/the-only-list-in-the-world/$', 'lists.views.view list', 
name='View_List' 


)， 


# url(r'^admin/', include(admin.site.urls)), 


) 
再 次 运行 测试 ， 得 到 的 结果 如 下 : 


AttributeError: 'module' object has no attribute 'view list' 
Lisa:] 


django.core.exceptions.ViewDoesNotExist: CouLd not import 
lists.views.view list. View does not exist in module lists.views. 


6.5.3 ”一 个 新 视图 函数 
这 个 结果 无 需 过 多 解说 。 下 面 在 lists/views.py 中 定义 一 个 新 视图 函数 : 





lists/views.py 


def view list(request): 
pass 


现在 测试 的 结果 变 成 了 : 


ValueError: The view lists.views.view list didn't return an HttpResponse 
object. It returned None instead. 


把 home_page 视图 的 最 后 两 行 复制 过 来 ， 看 能 否 骗 过 测试 


lists/views.py 


def view list(request): 
items = Item.objects.all() 
return render(request, 'home.html', {'items': items}) 
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再 次 运行 测试 ， 测 试 应 该 能 通过 了 : 


Ran 8 tests in 0.016s 
OK 


而 且 功 能 测试 也 有 一 点 进展 了 : 


AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers'] 


变 绿 了 了 吗 ? 该 重 构 了 
该 清理 一 下 测试 了 。 


在 “ 遇 红 / 变 绿 / 重 构 ” 流 程 中 ,已 经 走 到 “ 变 绿 ”这 一 步 ， 接 下 来 该 重 构 了 。 现 在 我 们 
有 两 个 视图 ， 一 个 用 于 首页 ， 一 个 用 于 单个 清单 。 目 前 ， 这 两 个 视图 共用 一 个 模板 ， 而 且 
传人 了 数据 库 中 的 所 有 待 办 事项 。 如 果 仔 细 查 看 单元 测试 中 的 方法 ， 或 许 会 发 现 某 些 部 分 
需要 修改 : 

















$ grep -E "class|def" lists/tests.py 
class HomePageTest(TestCase) : 
def test_root_UrL_resoLves_to_home_page_Vview(seLf) : 
def test_home_page_returns_correct_htmL(seLf) : 
def test home page displays_all list items(self): 
def test home page_can_save a_POST_request(self): 
def test home page_redirects after_POST(self): 
def test home page_only_saves_items when_necessary(self): 
class ListViewTest(TestCase): 
def test displays_all items(self): 
class ItemModelTest(TestCase): 
def test saving_and_retrieving items(self): 


完全 可 以 把 test_home_page_displays_all_list_items 方法 删除 ， 因 为 不 需要 了 。 如 果 现 
在 执行 manage.py test lists 命令 ， 应 该 会 看 到 运行 了 7 个 测试 ， 而 不 是 8 个: 





Ran 7 tests in 0.016s 
OK 





I 


而 且 ， 不 再 需要 在 首页 中 显示 所 有 的 待 办 事项 ， 首 页 只 显示 一 个 输入 框 让 用 户 新 建 清 
即 可 。 


6.5.4 ”一 个 新 模板 ， 用 于 查看 清 
既然 首页 和 清单 视图 是 不 同 的 页 面 ， 它 们 就 应 该 使 用 不 同 的 HTML 模板 。home.html 可 以 
只 包含 一 个 输入 框 ， 新 模板 list.html 则 在 表格 中 显示 现 有 的 待 办 事项 。 


下 面 添加 一 个 新 测试 ， 检 查 是 否 使 用 了 不 同 的 模板 : 


















































lists/tests.py 


class ListViewTest(TestCase): 


def test uses_ list template(self): 
response = self.client.get('/lists/the-only-list-in-the-world/') 
self.assertTemplateUsed(response, 'list.html') 


def test displays_all_ items(self): 
[i 


assertTemplateUsed 是 Django 测试 客户 端 提供 的 强大 方法 之 一 。 看 一 下 测试 的 结果 如 何 : 

















AssertionError: False is not true : Template "List.htmL' was not a template 
Used to render the response. Actual template(s) used: home.html 


很 好 ! 然后 修改 视图 : 


lists/views.py 


def view list(request): 
items = Item.objects.all() 
return render(request, 'list.html', {'items': items}) 





不 过 很 显然 ， 这 个 模板 还 不 存在 。 如 果 运 行 单元 测试 ， 会 得 到 如 下 结果 : 


django.template.base.TemplateDoesNotExist: list.html 





新 建 一 个 文件 ， 保 存 为 lists/templates/list.html: 


$ touch LiLsts/tempLates/LiLst.htmL 


这 个 模板 是 空 的 ， 测 试 会 显示 如 下 错误 一 一 镁 好 有 测试 ， 我 们 才 不 会 忘记 输入 内 容 : 


AssertionError: False is not true : Couldn't find 'itemey 1' in response 














单个 清单 的 模板 会 用 到 目前 home.html 中 的 很 多 代码 ， 所 以 可 以 先 把 其 中 的 内 容 复 制 过 来 : 





$ cp Lists/tempLates/home.htmL lists/templates/list.html 


这 会 让 测试 再 次 通过 ( 变 绿 )。 现 在 要 做 一 些 清理 工作 ( 重 构 )。 我 们 说 过 ， 首 页 不 用 显示 
待 办 事项 ， 只 放 一 个 新 建 清单 的 输入 框 就 行 。 因此， 可 0 30 
的 一 些 人 代码， 或 许 还 可 以 把 hi 改 成 “Start a new To-Do list” 
























































lists/templates/home.html 


<body> 
<h1>Start a new To-Do list</h1> 
<form method="POST"> 
<input name="item text" id="id new item" placeholder="Enter a to-do item" /> 
{% csrf_token %} 
</form> 
</body> 
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再 次 运行 测试 ， 确 认 这 次 改动 没有 破坏 任何 功能 。 很 好 ， 继 续 清 理 。 

















在 home_page 视图 中 其 实 也 不 用 把 全 部 待 办 事项 都 传 入 home.html 模板 ， 因 此 可 以 把 home_ 
page 视图 简化 成 : 














lists/views.py 
def home_page(request): 
if request.method == 'POST': 
Item.objects.create(text=request.POST['item text']) 
return redirect('/lists/the-only-list-in-the-world/') 
return render(request, 'home.html') 


再 次 运行 单元 测试 ， 它 们 仍然 能 通过 。 然 后 运行 功能 测试 : 


AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers ' ] 





输入 第 二 个 待 办 事项 时 还 是 失败 。 这 是 怎么 回 事 呢 ? 问题 的 原因 是 新 建 待 办 事项 的 表单 没 
有 action= 属性 ， 因 此 上 默认 情况 下 ， 提 交 地 址 就 是 泻 染 表单 的 页 面 地 址 。 表 单 在 首页 中 可 
用 ， 因 为 首页 是 目前 唯一 知道 如 何 处 理 POST 请 求 的 页 面 ， 但 在 视图 函数 vtew_List 中 不 
能 用 了 ，POST 请 求 会 直接 被 忽略 。 

















可 以 在 lists/templates/list.html 中 修正 这 个 问题 : 





lists/templates/list.html (ch061019) 


<form method="POST" action="/"> 
然后 再 试 试 运行 功能 测试 : 
self.assertNotEqual(francis_list url, edith list_url) 


AssertionError: 'http://Llocalhost:8081/lists/the-only-list-in-the-world/' == 
'http://Llocalhost:8081/lists/the-only-list-in-the-world/’' 











太 好 了 ! 重新 回 到 了 修改 前 的 状态 ， 这 意味 着 重 构 结束 了 一 一 现在 清单 有 唯一 的 URL 了 。 
你 可 能 觉得 并 没有 取得 太 多 进展 ， 因 为 网 站 的 功能 和 本 章 开始 时 儿 平 一 模 一 样 。 其 实 有 进 
展 ， 我 们 正在 实现 新 设计 ， 在 前 进 的 道路 上 铺 好 了 几 块 垫 脚 石 ， 而 且 网 站 的 功能 几乎 没 
变 。 提 交 目 前 取得 的 进展 : 











$ git status # 会 看 到 4 个 改动 的 文件 和 1 个 新 文件 list.html 
$ git add LiLsts/tempLates/LiLst.htmL 
$ git diff # 会 看 到 我 们 简化 了 home.html， 
# 把 一 个 测试 移 到 了 lists/tests.py 中 的 新 类 里 
# 在 views .py 中 添加 了 一 个 新 视图 
# 还 简化 了 home_page 视 图 ,并 在 urts.py 中 增加 了 一 个 映射 
$ git commit -a # 编写 一 个 消息 概述 以 上 操作 ,或 许可 以 写成 
# "new URL, view and template to display lists" 















































6.6 ”用 于 添加 待 办 事项 的 URL 和 视图 


看 一 下 待 办 事项 清单 ， 现 在 到 哪 一 步 了 呢 ? 














< -功能 训 斌 运行 完 单 后 青 理 

己 。 调 整 模型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 

< 。 为 委 个 清单 添加 叭 一 的 URL 

。 添 加 通过 POCT 请 求 新 建 清单 所 需 的 URL 

。 添 加 通过 POCT 请 求 在 现 什 的 清单 中 增加 新 待 办 事项 所 需 的 URL 


> \ A 了 A A a ee 
Ll BA 人 pp : 隐 - >、 We Sa hh 本 i 
A wm 了 











第 三 个 问题 已 经 取得 了 一 定 进展 ， 不 过 网 站 中 还 是 只 有 一 个 清单 。 第 二 个 问题 有 点 吓人 。 
对 第 四 或 第 五 个 问题 我 们 能 做 些 什么 呢 ? 


I 








7 








下 面 添 加 一 个 新 URL， 用 于 新 建 待 办 事项 。 这 么 做 至 少 能 简化 首页 视图 














6.6.1 用 来 测试 新 建 清单 的 测试 类 
打开 文件 lists/tests.py， 把 test_home_page_can_save_a_POST_request 和 test_home_page_ 
redirects_after_POST 两 个 方法 移 到 一 个 新 类 中 ， 然 后 再 修改 这 两 个 方法 的 名 字 : 




















lists/tests.py (ch061021-1) 
class NewListTest(TestCase): 


def test saving a_POST_request(self): 
request = HttpRequest() 
request.method = 'POST' 


[2] 


def test_redirects_after_POST(self): 
[ss 


然后 使 用 Django 测试 客户 端 重 写 : 


lists/tests.py (ch061021-2) 


class NewListTest(TestCase): 


def test_saving_a_POST_request(self): 
self.client.post( 
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' /Lists/new ' ， 
data={'item text': 'A new list item'} 
) 
self.assertEqual(Item.objects.count(), 1) 
new_item = Item.objects.first() 
self.assertEqual(new_item.text, 'A new list item') 


def test _ redirects_after_POST(self): 
response = self.client.post( 
' /Lists/new ' ， 
data={'item text': 'A new list item'} 
) 
self.assertEqual(response.status_code, 302) 
self.assertEqual(response['location'], '/lists/the-only-list-in-the- 
world/') 














顺便 说 一 句 ， 这 里 也 要 注意 末尾 的 斜 线 一 一 /new 后 面 不 加 斜 线 。 我 的 习惯 是 ， 不 在 修改 数 


据 库 的 “操作 ”后 加 斜 线 。 





运行 这 个 测试 试 试 : 


self.assertEqual(Item.objects.count(), 1) 
AssertionError: 0 != 1 


[sl 


self.assertEqual(response.status_code, 302) 
AssertionError: 404 != 302 


第 一 个 失败 消息 告诉 我 们 ， 新 建 的 待 办 事项 没有 存 和 数据库。 第 二 个 失败 消息 指出 视图 返 
回 的 状态 码 是 404， 而 不 是 表示 重 定向 的 302。 这 是 因为 还 没 把 /lists/new 添加 到 URL 映射 
中 ， 所 以 client.post 得 到 的 是 404 响应 。 











还 记得 前 一 章 我 们 是 如 何 把 这 种 测试 分 成 两 个 测试 方法 的 吗 ? 如 果 在 一 个 测 
试 方法 中 同时 测试 保存 数据 和 重 定向 ， 看 到 的 失败 消息 就 是 9 != 1， 调 试 起 
来 更 难 。 如 果 你 好 奇 我 是 怎么 知道 要 这 么 做 的 ， 不 要 犹 涂 ， 问 我 吧 。 








6.6.2 ”用 于 新 建 清单 的 URL 和 视图 
下 面 添 加 新 的 URL 映射 : 














superlists/urls.py 


urlpatterns = patterns('', 
url(r'^$', 'lists.views.home page', name='home'), 
url(r'^lists/the-only-list-in-the-world/$', 'lists.views.view_ list', 
name='View_List' 
)， 
url(r'^lists/new$', 'lists.views.new_ list', name='new_list'), 
# url(r'^admin/', include(admin.site.urls)), 
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再 运行 测试 ， 会 得 到 ViewDoesNotExist 错误 。 修 正 这 个 问题 ， 在 文件 lists/views.py 中 写 入 : 


lists/views.py 


def new_list(request): 
pass 


再 运行 测试 ， 得 到 的 失败 消息 是 :“The view lists.views.new_list didn’*t return an HttpResponse 
object”(lists.views.new_list 视图 没 返回 HttpResponse 对 象 )。 这 个 消息 很 眼熟 。 虽 然 可 
以 返回 一 个 原始 的 HttpResponse 对 象 ， 但 既然 知道 需要 的 是 重 定 向 ， 那 就 从 home_page 视 
图 中 借用 一 行 代码 吧 : 





lists/views.py 


def new_list(request): 
return redirect('/lists/the-only-list-in-the-world/') 





现在 测试 的 结果 是 : 
seLf .assertEquaL(Item.objects.count()，1) 
AssertionError: 0 != 1 
[2 


AssertionError: 'http://testserver/lists/the-only-list-in-the-world/' != 
'/lists/the-only-list-in-the-world/' 











先 解决 第 一 个 失败 ， 因 为 失败 消息 比较 直观 。 再 从 home_page 视图 中 借用 一 行 代码 : 








lists/views.py 


def new_list(request): 
Item.objects.create(text=request.POST['item text']) 
return redirect('/lists/the-only-list-in-the-world/') 


加 入 这 行 代码 后 ， 测 试 的 结果 只 剩 第 二 个 失败 了 ， 而 且 是 意料 之 外 的 失败 : 


self.assertEqual(response['location'], '/lists/the-only-list-in-the-world/') 
AssertionError: 'http://testserver/lists/the-only-list-in-the-world/' != 
'/lists/the-only-list-in-the-world/' 


出 现 这 个 失败 的 原因 是 ，Django 测试 客户 端的 表现 和 纯正 的 视图 函数 有 细微 差别 : 测试 客 


户 端 使 用 完整 的 Django 组 件 ， 会 在 相对 URL 前 加 上 域名 。 使 用 Django 提供 的 另 一 个 测试 
辅助 函数 换 掉 重 定向 的 两 步 检查 : 











lists/tests.py 
def test_ redirects_after_POST(self): 
response = self.client.post( 
'/lists/new', 
data={'item text': 'A new list item’'} 
) 


self.assertRedirects(response, '/lists/the-only-list-in-the-world/') 
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现在 测试 能 通过 了 : 
Ran 8 tests in 0.030s 


OK 


6.6.3 ”删除 当前 多 余 的 代码 和 测试 
看 起 来 不 错 。 既 然 新 视图 完成 了 以 前 home_page 视图 的 大 部 分 工作 ， 应 该 就 可 以 大 幅度 精 
简 home_page 了 。 比如 说 ， 可 以 删除 整个 if request.method == 'P0ST' 部 分 吗 ? 








lists/views.py 


def home_page(request): 
return render(request, 'home.html') 


当然 可 以 ! 
OK 


既然 已 经 动手 简化 了 ， 还 可 以 把 当前 多 余 的 测试 方法 test_home_page_only_saves_items 
when_necessary 也 删 掉 。 





删 掉 之 后 是 不 是 感觉 挺 好 的 ? 视图 函数 变 得 更 简洁 了 。 再 次 运行 测试 ， 确 认 一 切 正 常 : 





Ran 7 tests in 0.016s 
OK 


6.6.4 让 表单 指向 刚 添 加 的 新 URL 


最 后 ， 修 改 两 个 表单 ， 让 它们 使 用 刚 添加 的 新 URL。 在 home.html 和 lists.html 中 ， 把 表单 
改 成 ， 








lists/templates/home.html, lists/templates/list.html. 


<form method="POST" action="/lists/new"> 
然后 运行 功能 测试 ， 确 保 一 切 仍 能 正常 运行 ， 或 者 至 少 和 修改 前 的 状态 一 样 : 
AssertionError: 'http://Llocalhost:8081/lists/the-only-list-in-the-world/' == 
'http://Llocalhost:8081/lists/the-only-list-in-the-world/' 
是 的 ， 我 们 回 到 了 之 前 的 状态 。 以 上 操作 可 以 作为 一 次 完整 的 提交 : 对 URL 映射 做 了 些 
改动 ，views.py 看 起 来 也 精简 多 了 ， 而 且 能 保证 应 用 还 能 像 以 前 那样 正常 运行 。 我 们 的 重 
构 技术 变 得 越 来 越 好 了 | 
$ git status # 5 个 改动 的 文件 
$ git diff # 在 两 个 表单 中 添加 了 URL ,视图 和 测试 都 有 代码 移动 ,还 添加 了 一 个 新 URL 


$ git commit -a 
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可 以 在 待 办 事项 清单 中 划 掉 一 个 问题 了 : 











二 。- 瑟 能 浏 斌 运行 完 华 后 清 再 
< 。 调 整 模型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 
E: 。 为 香 个 清单 添加 唯一 的 URL 





> 二- 和 入 664F 放 来 新 六 江 半 拟人 人 HR 
< 。 添 加 通过 pOGT 请 求 在 现 省 的 清单 中 增加 新 待 办 事项 所 需 的 URL 





以 Ah 全 ol oh 人 > 
cg A ”~ ” p> Ah A A py b 
Y 








6.7 ”调整 模型 


关于 URL 的 清理 工作 做 得 够 多 了 ， 现 在 下 定 决心 修改 模型 。 先 调整 模型 的 单元 测试 。 这 





次 换 种 方式 ， 以 差异 的 形式 表示 改动 的 地 方 : 


lists/tests.py 


@@ -3,7 +3,7 @@ from django.http import HttpRequest 
from django.tempLate.Loader import render_to_string 
from django.test import TestCase 


-from lists.models import Item 
+from lists.models import Item, List 
from lists.views import home_page 


class HomePageTest(TestCase) : 
QQ -60,22 +60,32 QQ class ListViewTest(TestCase): 
-CLass ItemModeLTest(TestCase) : 


+CLass ListAndItemModeLsTest(TestCase) : 


def test saving_and_retrieving items(self): 
+ Iasi er lt 全) 


+ list_.save() 
最 
first item = Item() 
first item.text = 'The first (ever) list item' 
+ first item.list = list_ 
first item.save() 
second_item = Item() 
second_item.text = 'Item the second' 
+ second_itenm.list = list_ 
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second_item.save() 


+ saved_list = List.objects.first() 
+ self.assertEqual(saved_list, list ) 
ey 
saved_items = Item.objects.all() 
self.assertEqual(saved_items.count(), 2) 
first_saved_item = saved_items[0] 
second_saved item = saved items[1] 
self.assertEqual(first_saved item.text, 'The first (ever) list item') 
+ self.assertEqual(first_saved_item.list, list ) 
self.assertEqual(second_saved_item.text, 'Item the second') 
+ self.assertEqual(second_saved item.list, list ) 


新 建 了 一 个 List 对 象 ， 然 后 通过 给 .list 属性 赋值 把 两 个 待 办 事项 归 在 这 个 对 象 名 下 。 要 
检查 这 个 清单 是 否 正 确保 存 ， 也 要 检查 是 否 保 存 了 那 两 个 待 办 事项 与 清单 之 间 的 关系 。 你 

还 会 注意 到 可 以 直接 比较 两 个 清单 (saved_list 和 tist) 一 一 其 实 比 较 的 是 两 个 清单 的 主 
键 (.id 属性 ) 是 否 相同 。 


























我 使 用 变量 名 List_ 的 目的 是 防止 遮盖 Python 原生 的 List 函数 。 这 么 写 可 
E 不 美观 ， 但 我 能 想到 的 其 他 写法 也 同样 不 美观 ， 或 者 更 糟 ， 比 如 my_list、 


the_list、1list1、listey 等 。 





























现在 要 开始 另 一 个 “单元 测试 /编写 代码 ”循环 了 。 


在 前 几 次 迭代 中 ， 我 只 给 出 每 次 运行 测试 时 期 望 看 到 的 错误 消息 ， 不 会 告诉 你 运行 测试 前 
要 输入 哪些 代码 ， 你 要 自己 编写 每 次 所 需 的 最 少 代码 改动 。 


你 首先 看 到 的 错误 消息 是 : 








ImportError: cannot import name 'List' 
解决 这 个 错误 后 ， 再 次 运行 测试 会 看 到 : 

AttributeError: 'List' object has no attribute "save' 
然后 会 看 到 : 

django.db.utils.OperationalError: no such table: lists_ list 
因此 需要 执行 一 次 makemigrations 命令 : 

$ python3 manage.py makemigrations 

Migrations for 'lists': 


0003_list.py: 
- Create model List 





然后 会 看 到 : 


self.assertEqual(first saved itenm.list, list ) 
AttributeError: 'Item' object has no attribute "List' 


6.7.1 通过 外 键 实现 的 关联 


Iten 的 List 属性 应 该 怎么 实现 呢 ? 先天 真一 点 ， 把 它 当成 text 属性 试 试 : 








lists/models.py 


from django.db import models 


class List(models.Model): 
pass 


class Item(models.Model): 
text = models.TextField(default='') 
list = models.TextField(default='') 


照例 ， 测 试 会 告诉 我 们 需要 做 一 次 迁移 : 


$ python3 manage.py test lists 
[si] 


django.db.utils.OperationalError: table lists_ item has no column named list 


$ python3 manage.py makemigrations 
Migrations for 'lists': 
0004_item list.py: 
- Add field list to item 





看 一 下 测试 结果 如 何 : 


AssertionError: 'List object' != <List: List object> 





Hd 


离 成 功 还 有 一 段 距离 。 请 仔细 看 != 两 边 的 内 容 。Django 只 保存 了 List 对 象 的 字符 
形式 。 若 想 保 存 对 象 之 间 的 关系 ， 要 告诉 Django 两 个 类 之 间 的 关系 ， 这 种 关系 使 用 
ForeignKey 字段 表示 : 


lists/models.py 


from django.db import models 
class List(models.Model): 


pass 


class Item(models.Model): 
text = models.TextField(default='') 
list = models.ForeignKey(List, default=None) 


修改 之 后 也 要 做 一 次 迁移 。 既 然 前 一 个 迁移 没 用 了 ， 就 把 它 删 掉 吧 ， 换 一 个 新 的 : 
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$ rm lists/migrations/0004_item list.py 
$ python3 manage.py makemigrations 
Migrations for 'lists': 
0004_item list.py: 
- Add field list to item 





删除 迁移 是 种 危险 操作 。 如 果 删 除 已 经 用 于 某 个 数据 库 的 迁移 ，Django 就 
不 知道 当前 状态 ， 因 此 也 就 不 知道 如 何 运 行 以 后 的 迁移 。 只 有 当 你 确定 某 
个 迁移 没 被 使 用 时 才能 将 其 删除 。 根 据 经验 ， 已 经 提交 到 VCS 的 迁移 决 不 
能 删除 。 























6.7.2 ”根据 新 模型 定义 调整 其 他 代码 
再 看 测 试 的 结果 如 何 : 





$ python3 manage.py test lists 

| | 

ERROR: test_ displays_all items (lists.tests.ListViewTest) 
django.db.utils.IntegrityError: NOT NULL constraint failed: lists_ item.list id 
[3 

ERROR: test_redirects_after_POST (lists.tests.NewListTest) 
django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 
Lx] 

ERROR: test_saving_a_POST_request (lists.tests.NewListTest) 
django.db.utils.IntegrityError: NOT NULL constraint failed: lists_ item.list id 


Ran 7 tests in 0.021s 

FAILED (errors=3) 
天 啊 ， 这 人 么 多 错误 。 
可 是 也 有 一 些 好 消息 。 虽 然 很 难看 出 ， 不 过 模型 测试 通过 了 。 但 是 三 个 视图 测试 出 现 了 重 
大 错误 。 
出 现 这 些 错误 是 因为 我 们 在 待 办 事项 和 清单 之 间 建 立 了 关联 ， 在 这 种 关联 中 ， 每 个 待 办 事 
项 都 需要 一 个 父 级 清单 ， 但 是 原来 的 测试 并 没有 考虑 到 这 一 点 。 


不 过 ， 这 正 是 测试 的 目的 所 在 。 下 面 要 让 测试 再 次 通过 。 最 简单 的 方法 是 修改 ListVienTest， 
为 测试 中 的 两 个 待 办 事项 创建 父 清单 ， 









































健 





lists/tests.py (ch061031) 


class ListViewTest(TestCase): 


def test displays all items(self): 
list_ = List.objects.create() 
Item.objects.create(text='itemey 1', list=list ) 
Item.objects.create(text='itemey 2', list=list ) 

















修改 之 后 ， 失 败 测试 减少 到 两 个 ， 而 且 都 是 向 new_tist 视图 发 送 POST 请 求 引起 的 。 使 用 
惯用 的 技术 分 析 调 用 跟踪 ， 由 错误 消息 找到 导致 错误 的 测试 代码 ， 然 后 再 找 出 相应 的 应 用 
代码 ， 最 终 定位 到 下 面 这 行 : 








File "/workspace/superlists/lists/views.py", line 14, in new_list 
Item.objects.create(text=request.POST['item text']) 








这 行 调用 跟踪 表明 创建 待 办 事项 时 没有 指定 父 清单 。 因 此 ， 要 对 视图 做 类 似 修改 : 











lists/views.py 
from lists.models import Item, List 


| 

def new_list(request): 
list_ = List.objects.create() 
Item.objects.create(text=request.POST['item text'], list=list_ ) 
return redirect('/lists/the-only-list-in-the-world/') 


修改 之 后 ， 测 试 又 能 通过 了 : 


OK 











人 但 还 是 集中 
显示 所 有 待 办 事项 ， 感觉 这 么 做 完全 不 对 。 我 知道 不 
es 致 ， 要 求 代码 从 一 个 可 用 状态 变 
成 另 一 个 可 用 状态 。 我 总 想 直接 动手 一 次 修正 所 有 问题 ， 而 不 想 把 一 个 奇怪 的 半成品 变 成 
另 一 个 半成品 。 可 是 你 还 记得 测试 山羊 吧 ? 候 山 时 ， 你 要 审慎 抉择 每 一 步 踏 在 何 处 ， 而 且 
一 次 只 能 迈 一 步 ， 确 认 脚 踩 的 每 一 个 位 置 都 不 会 让 你 跌落 悬 岩 。 




















因此 ， 为 了 确信 一 切 都 能 正常 运行 ， 要 再 次 运行 功能 测试 。 毫 无 疑问 ， 测 试 的 结果 和 修改 
前 一 样 。 现 有 功能 没有 破坏 ， 在 此 基础 上 还 修改 了 数据 库 。 这 一 点 令 人 欣喜 ! 下 面 提 交 : 




















$ git status # 改动 了 3 个 文件 ,还 新 建 了 2 个 迁移 
$ git add lists 

$ git diff --staged 

$ git commit 


又 可 以 从 待 办 事项 清单 上 划 掉 一 个 问题 了 : 
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SS 


二 
UU 


。 调 登 模 型 让 待 办 事项 和 不 同 的 清单 关联 起 来 

。 为 委 个 清单 添加 叭 一 的 URL 

。 添 加 通过 pPOGF 请 求 新 建 清单 所 需 的 HRL 

。 添 加 通过 POST 请 求 在 现 用 的 清单 中 增加 新 待 办 事项 所 需 的 URL 


六 已 9 
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6.8 


应 该 使 月 
库 








每 个 列表 都 应 该 有 自己 的 URL 


目 什 么 作为 清单 的 唯一 标识 符 呢 ? 就 目前 而 言 ， 或 许 最 简单 的 处 到 





方式 是 使 用 数据 














自动 生成 的 id 字段 。 下 面 修改 ListviewTest， 让 其 中 的 两 个 测试 指向 新 URL。 





还 要 把 test_displays_all_items 测试 重 命名 为 test_displays_only_items_for_that_list,，, 


然后 在 这 





cla 











个 测试 中 确认 只 显示 属于 这 个 清单 的 待 办 事项 : 














lists/tests.py (ch061033-1) 


ss ListViewTest(TestCase): 


def test uses_ list template(self): 
List_ = List.objects.create() 
response = self.client.get('/lists/%d/' % (list_.id,)) 
self.assertTemplateUsed(response, 'list.html') 





def test displays_only_items for_that_list(self): 

correct _ list = List.objects.create() 
Item.objects.create(text='itemey 1', list=correct_ list) 
Item.objects.create(text='itemey 2', list=correct list) 
other_list = List.objects.create() 
Item.objects.create(text='other list item 1', list=other_list) 
Item.objects.create(text='other list item 2', list=other_list) 
response = self.client.get('/lists/%d/' % (correct list.id,)) 
self.assertContains(response, 'itemey 1') 
self.assertContains(response, 'itemey 2') 
self.assertNotContains(response, 'other list item 1') 
self.assertNotContains(response, 'other list item 2') 
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如 果 你 不 熟悉 Python 的 字符 串 代 换 ， 或 者 C 语言 中 的 printf 函数 ， 或 许 
就 不 知道 qd 是 什么 意思 。 如 果 你 想 快速 了 解 ， 可 以 阅读 Dive Into Python 
(http://www.diveintopython.net/)， 这 本 书 对 字符 串 代 换 做 了 很 好 的 介绍 。 后 


文 还 会 介绍 另 一 种 字符 串 代 换 句 法 。 














运行 这 个 单元 测试 ， 会 看 到 预期 的 404， 以 及 另 一 个 相关 的 错误 : 


FAIL: test_dispLays_onLy_iLtems_for_that_List (lists.tests.ListViewTest) 
AssertionError: 404 != 200 : Couldn't retrieve content: Response code was 404 
(expected 200) 


[...] 


FAIL: test uses_list template (lists.tests.ListViewTest) 
AssertionError: No templates used to render the response 


6.8.1 捕获 URL 中 的 参数 


现在 要 学 习 如 何 把 URL 中 的 参数 传 入 视图: 
superlists/urls.py 
urlpatterns = patterns('', 
url(r'^$', 'lists.views.home_ page', name='home'), 
url(r'^lists/(.+)/$', 'lists.views.view list', name='view_list'), 
url(r'^lists/new$', 'lists.views.new_ list', name='new_list'), 
# url(r'^admin/', include(admin.site.urls)), 


) 


调整 URL 映射 中 使 用 的 正则 表达 式 ， 加 入 一 个 “捕获 组 ”(capture group) (.+)， 它 能 匹 
配 随后 的 / 之 前 任意 个 字符 。 捕 获得 到 的 文本 会 作为 参数 传 入 视图 。 


也 就 是 说 ， 如 果 访 问 /lists/1/，view_list 视图 除了 常规 的 request 参数 之 外 ， 还 会 获得 第 
二 个 参数 ， 即 字符 串 "1"。 如 果 访 问 /lists/foo/， 视 图 就 是 vitew_List(request，"foo" )。 








但 是 视图 并 未 期 待 有 参数 传人 ， 毫 无 疑问 ， 这 么 做 会 导致 问题 : 


ERROR: test_displays_only_items_for_that_list (lists.tests.ListViewTest) 
ERROR: test uses_list template (lists.tests.ListViewTest) 
ERROR: test_redirects_after_POST (lists.tests.NewListTest) 


[ea] 


TypeError: view list() takes 1 positional argument but 2 were given 
这 个 问题 容易 修正 ， 在 views.py 中 加 入 一 个 参数 即 可 : 
lists/views.py 


def view list(request, list id): 


[...] 
现在 ， 前 面 那 个 预期 失败 解决 了 : 






































完成 最 简 可 用 的 网 站 | 95 


FAIL: test displays_only_items for that list (lists.tests.ListViewTest) 
AssertionError: 1 != 0 : Response should not contain 'other list item 1' 





接 下 来 要 让 视图 决定 把 哪些 待 办 事项 传人 模板 : 














lists/views.py 
def view list(request, list id): 
list = List.objects.get(id=list id) 
items = Item.objects.filter(list=list ) 
return render(request, 'list.html', {'items': items}) 
i \ 站 LA . » 
6.8.2 ”按照 新 设计 调整 new_list 视 图 
现在 得 到 发 生 在 另 一 个 测试 中 的 错误 : 
ERROR: test_ redirects after_POST (lists.tests.NewListTest) 
ValueError: invalid literal for int() with base 10: 
'the-only-list-in-the-world' 
既然 这 个 测试 报错 了 ， 就 来 看 看 它 的 代码 吧 : 
lists/tests.py 


class NewListTest(TestCase): 


[...] 


def test redirects after_POST(self): 
response = self.client.post( 
' /Lists/new ' ， 
data={'item text': 'A new list item'} 
) 


self.assertRedirects(response, '/lists/the-only-list-in-the-world/') 








看 样子 这 个 测试 还 没 按照 清单 和 待 办 事项 的 新 设计 调整 ， 它 应 该 检查 视图 是 否 重 定 问 到 新 
建 清单 的 URL: 








lists/tests.py (ch061036-1) 
def test_redirects_after_POST(self): 

response = self.client.post( 

' /Lists/new ' ， 

data={'item text': 'A new list item'} 
) 
new_List = List.objects.first() 
self.assertRedirects(response, '/lists/%d/' % (new_list.id,)) 





修改 后 测试 还 是 得 到 无 效 字面 量 错误 。 检 查 一 下 视图 本 身 ， 把 它 改 为 重 定 向 到 有 效 的 地 址 : 


lists/views.py (ch061036-2) 
def new_list(request): 
list = List.objects.create() 





Item.objects.create(text=request.POST['item text'], list=list ) 
return redirect('/lists/%d/' % (list_.id,)) 








这 样 修改 之 后 单元 测试 就 可 以 通过 了 。 那 么 功能 测试 结果 如 何 ， 差 不 多 也 能 通过 吧 ? 








AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Use 
peacock feathers to make a fly'] 





功能 测试 提醒 我 们 ， 应 用 中 有 一 个 回归 : 现在 每 个 POST 请 求 都 会 新 建 一 个 清单 ， 破 坏 了 
向 一 个 清单 中 添加 多 个 待 办 事项 的 功能 。 这 就 是 我 们 编写 功能 测试 的 目的 | 
































而 这 正好 和 待 办 事项 清单 中 最 后 一 个 问题 高 度 吻 合 : 














“功能 训 谍 远 行 完 理 乒 请 理 
.调整 模型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 
“办 和 个 济 单 添加 毕 一 的 UL 


A A A 














。- 话 加 通过 POST 请 求 新 建 清单 所 宕 的 URE 
< 。 添 加 通过 pOcT 请 求 在 现 过 的 清单 中 增加 新 待 办 事项 所 需 的 URL 
Le 人 ~ 人 A Es A >A A a 和 > A ee、 











6.9 ”还 需要 一 个 视图 ， 把 待 办 事项 加 入 现 有 清 


还 需要 一 个 URL 和 视图 (/lists/<list_id>/add_item)， 把 新 待 办 事项 添加 到 现 有 的 清单 中 。 
我 们 已 经 熟知 这 种 操作 了 ， 因 此 可 以 一 次 写 好 两 个 测试 : 




















lists/tests.py 


class NewItemTest(TestCase): 
def test can_save_a_POST_request to _ an existing list(self): 
other_list = List.objects.create() 
correct list = List.objects.create() 


self.client.post( 
'/lists/%d/add item' % (correct list.id,), 
data={'item text': 'A new item for an existing list'} 


) 


self.assertEqual(Item.objects.count(), 1) 

New_item = Item.objects.first() 

self.assertEqual(new_item.text, 'A new item for an existing list') 
self.assertEqual(new_item.list, correct list) 
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def test_redirects_to_List_view(seLf) : 
other_List = List.objects.create() 
correct list = List.objects.create() 


response = self.client.post( 
' /Lists/%d/add item' % (correct list.id,), 
data={'item text': 'A new item for an existing list'} 


) 


self.assertRedirects(response, '/\lists/%d/' % (correct_list.id,)) 


测试 的 结果 为 : 


AssertionError: 0 != 1 


[ss 
AssertionError: 301 != 302 : Response didn't redirect as expected: Response 
code was 301 (expected 302) 


6.9.1 小 心 霸道 的 正则 表达 式 


有 点 奇怪 ， 还 没 在 URL 映射 中 加 入 /lists/1/add_item， 应 该 得 到 404 != 302 错误 ， 怎 么 会 
是 301 呢 ? 





确认 令 人 费解 。 其 实 得 到 这 个 错误 是 因为 在 URL 映射 中 使 用 了 一 个 非常 霸道 的 正则 表达 式 ; 














url(r'^lists/(.+)/$', 'lists.views.view list', name='view_ list'), 


根据 Django 的 内 部 处 理 机 制 ， 如 果 访 问 的 URL 几乎 正确 ， 但 却 少 了 末尾 的 斜 线 ， 就 会 
得 到 一 个 永久 重 定向 响应 (301)。 在 这 里 ，/lists/1/add_item/ 符合 Lists/(.+)/ 的 匹配 模 
式 ， 其 中 (.+) 捕获 1/add_item， 所 以 Django 伸 出 “援手 ”， 猜 测 你 其 实 是 想 访 问 末 尾 带 斜 
线 的 URL。 
































| 





这 个 问题 的 修正 方法 是 ， 显 式 指 定 URL 模式 只 捕获 数字 ， 即 在 正则 表达 式 中 使 用 \d: 

















AAA 


superlists/urls.py 


url(r'^lists/(\d+)/$', 'lists.views.view list', name='view_ list'), 


修改 后 测试 的 结果 是 : 


AssertionError: 0 != 1 


[xs] 
AssertionError: 404 != 302 : Response didn't redirect as expected: Response 
code was 404 (expected 302) 


6.9.2 ”最 后 一 个 新 URL 
现在 得 到 了 预期 的 404。 下 面 定义 一 个 新 URL， 用 于 把 新 待 办 事项 添加 到 现 有 清单 中 : 




















superlists/urls.py 


urlpatterns = patterns('', 
url(r'^$', 'lists.views.home_page', name='home'), 
url(r'^lists/(\d+)/$', 'lists.views.view list', name='view_ list'), 
url(r'^lists/(\d+)/add_item$', 'lists.views.add_ item', name='add_itenm'), 
url(r'^lists/new$', 'lists.views.new_list', name='new_list'), 
# url(r'^admin/', include(admin.site.urls)), 


) 
现在 URL 映射 中 定义 了 三 个 类 似 的 URL。 在 待 办 事项 清单 中 做 个 记录 ， 因 为 这 三 个 URL 
看 起 来 需要 重 构 。 


























S 
< 。 EN 运行 先 半 万 
S e 也 二 5 + 司 关 
C 。- 为 各 个 济 单 添加 叭 一 的 URL 
< . -添加 通过 POGT 请 求 新 建 清 单 所 需 的 HRL ~ -二 - 二 3 渚 间 
< 。 添 加 通过 POCT 请 求 在 现 什 的 清单 中 增加 新 待 办 事项 所 需 的 URL 
< 。 重 构 nlipy， 去 除 重复 
) 
有 
An Ah > AAA hs 4 AM 人 PPA7 
0 -A L ne、 eA ead Nye DB A > A We 














再 看 测试 ， 现 在 得 到 的 结果 是 : 


django.core.exceptions.ViewDoesNotExist: Could not import lists.views.add itenm. 
View does not exist in module lists.views. 


6.9.3 ”最 后 一 个 新 视图 
定义 下 面 这 个 视图 试 试 : 























lists/views.py 


def add_item(request): 
pass 


效果 不 错 : 
TypeError: add item() takes 1 positional argument but 2 were given 


继续 修改 视图 : 
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lists/views.py 


def add_ item(request, list id): 
pass 

















测试 的 结果 是 : 


VaLueError: The view lists.views.add item didn't return an HttpResponse object. 
It returned None instead. 


可 以 从 new_List 视图 中 复制 redirect， 从 view_list 视图 中 复制 List.objects .get: 


lists/views.py 
def add item(request, list id): 
list = List.objects.get(id=list id) 
return redirect('/lists/%d/' % (list_.id,)) 

















现在 测试 的 结果 为 : 


self.assertEqual(Item.objects.count(), 1) 
AssertionError: 0 != 1 


最 后 ， 让 视图 保存 新 建 的 待 办 事项 : 





lists/views.py 
def add_ item(request, list id): 
list = List.objects.get(id=list id) 
Item.objects.create(text=request.POST[ 'item text'], list=list_ ) 
return redirect('/lists/%d/' % (list_.id,)) 


这 样 ， 测 试 又 能 通过 了 : 





Ran 9 tests in 0.050s 


OK 


6.9.4 如 何在 表单 中 使 用 那个 URL 


现在 只 需 在 list.html 模板 中 使 用 这 个 URL。 打 开 这 个 模板 ， 修 改 表单 标签 : 





lists/templates/list.html 


<form method="POST" action="but what should we put here?"> 


可 是 ， 若 想 获 取 添 加 到 当前 清单 的 URL， 模 板 要 知道 它 泻 染 的 是 哪个 清单 ， 以 及 要 添加 哪 
些 待 办 事项 。 希 望 表 单 能 写成 下 面 这 样 : 








lists/templates/list.html 
<form method="POST" action="/lists/{{ list.id }}/add item"> 


为 了 能 这 样 写 ， 视 图 要 把 清单 传人 模板 。 下 面 在 ListviewTest 中 新 建 一 个 单元 测试 方法 : 




















lists/tests.py (chO61041) 


def test passes_ correct list to_ template(self): 
other_list = List.objects.create() 
correct list = List.objects.create() 
response = self.client.get('/lists/%d/' % (correct list.id,)) 
self.assertEqual(response.context['list'], correct_list) 





response.context 表示 要 传人 render 函数 的 上 下 文 一 一 Django 测试 客户 端 把 上 下 文 附 在 
response 对 象 上 ， 方便 测试 。 增 加 这 个 测试 后 得 到 的 结果 如 下 : 


KeyError: "List' 





Ba 





这 是 因为 没 把 tist 传人 模板 ， 其 实 也 给 了 我 们 一 个 简化 视 





| 





的 机 会 : 





lists/views.py 
def view list(request, list id): 
list = List.objects.get(id=list id) 
return render(request, 'list.html', {'list': list }) 


显然 这 么 做 会 导致 测试 失败 ， 因 为 模板 期 望 传 入 的 是 itens: 


AssertionError: False is not true : Couldn't find 'itemey 1' in response 





可 以 在 listhtml 中 修正 这 个 问题 ， 同 时 还 要 修改 表单 POST 请 求 的 目标 地 址 ， 即 action 属性 : 








lists/templates/list.html (ch061043) 
<form method="POST" action="/lists/{{ list.id }}/add item"> 


[a] 
{% for item in list.item set.all %} 


<tr><td>{{ forloop.counter }}: {{ item.text }}</td></tr> 
{% endfor %} 


.item_set 叫 作 “ 反 向 查询 ”(reverse lookup)， 是 Django 提供 的 非常 有 用 的 ORM 功能 ， 
可 以 在 其 他 表 中 查询 某 个 对 象 的 相关 记录 。 


修改 模板 之 后 ， 单 元 测试 能 通过 了 : 

















Ran 10 tests in 0.060s 


OK 





功能 测试 的 结果 如 何 呢 ? 


$ python3 manage.py test functionaL_tests 
Creating test database for alias 'default'... 


Ran 1 test in 5.824s 
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OK 
Destroying test database for alias 'default'... 


太 好 了 ! 再 看 一 下 待 办 事项 清单 : 






































< 。 调 天 模型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 
。- 为 和 匀 个 清单 添加 只 一 的 URL 











S 。 话 加 通 进 P6GT 请 求 新 建 清单 所 需 的 HR 
S ,添加 透 进 p6GF 请 求 在 抽 雷 的 清单 中 境 加 新 待 办 事项 所 需 的 HR 
< 。 重 构 uulspy， 去 除 重 复 




















可 异 ， 测 试 山羊 也 是 善 始 不 善终 的 ， 还 有 最 后 一 个 问题 没 解决 。 








在 解决 这 个 问题 之 前 ， 先 做 提交 一 一 着 手 重 构 之 前 一 定 要 提交 可 正常 运行 的 代码 : 


$ git diff 
$ git commit -am "new URL + view for adding to existing lists. FT passes :-)" 


6.10 使 用 URL 引 入 做 最 后 一 次 重 构 


superlists/urls.py 的 真正 作用 是 定义 整个 网 站 使 用 的 URL。 如 果 某 些 URL 只 在 Lists 应 用 
中 使 用 ，Django 建议 使 用 单独 的 文件 lists/urls.py， 让 应 用 自 成 一 体 。 定 义 lists 使 用 的 
URL， 最 简单 的 方法 是 复制 现 有 的 urls.py: 

















$ cp superlists/urls.py lists/ 


然后 把 superlists/urls.py 中 的 三 行 定义 换 成 一 个 inctude。 注 意 ，inctude 可 以 使 用 一 个 正 
则 表达 式 作为 URL 的 前 级 ， 这 个 前 级 会 添加 到 引入 的 所 有 URL 上 (这 就 是 我 们 去 除 重 复 
的 方法 ， 同 时 也 让 代码 结构 更 清晰 ) : 


superlists/urls.py 


urlpatterns = patterns('', 
url(r'^$', 'lists.views.home_page', name='home'), 
url(r'^lists/', include('lists.urls')), 
# url(r'^admin/', include(admin.site.urls)), 























在 lists/urls.py 中 只 需 包 含 那 三 个 URL 的 后 半 部 分 ， 而 且 不 用 再 写 父 级 urls.py 中 的 其 他 定义 : 


lists/urls.py(ch06/045) 


from django.conf.urls import patterns, url 


urlpatterns = patterns('', 
url(r'^(\d+)/$', 'lists.views.view list', name='view list'), 
url(r'^(\d+)/add item$', 'lists.views.add item', name='add_itenm'), 
url(r'^new$', 'lists.views.new_ list', name='new_list'), 
) 
再 次 运行 单元 测试 ， 确 认 一 切 仍 能 正常 运行 。 我 修改 时 ， 怀 疑 自 己 的 能 力 ， 不 确信 能 一 次 
改 对 ， 所 以 特意 一 次 只 改 一 个 URL， 防 止 测试 失败 。 如 果 改 错 了 ， 还 有 测试 提醒 我 们 。 


你 可 以 动手 试 一 下 。 记 得 要 改 回来 ， 而 且 要 确认 测试 全 部 都 能 通过 ， 然 后 再 提交 : 


$ git status 

$ git add lists/urls.py 

$ git add superlists/urls.py 

$ git diff --staged 

$ git commit 
终于 结束 了 ， 这 一 章 可 真 长 啊 。 我 们 讨论 了 很 多 重要 话题 ， 先 从 测试 隔离 开始 ， 然 后 又 思考 
了 设计 。 介 绍 了 一 些 经 验 法 则 ， 比 如 “YAGNI” 和 “ 事 不 过 三 ,三 则 重 构 ”"。 最 重要 的 是 ， 看 
到 了 如 何 一 步 步 修改 现 有 网 站 ， 从 一 个 可 运行 状态 变 成 另 一 个 可 运行 状态 ， 逐 渐 实 现 新 设计 。 
不 得 不 说 ， 我 们 的 网 站 已 经 非常 接近 发 布 状态 了 ， 也 就 是 说 ， 这 个 待 办 事项 清单 网 站 的 首 
个 测试 版 可 以 公之于众 了 。 不 过 ， 在 此 之 前 可 能 还 要 做 些 美化 。 在 接 下 来 的 几 章 中 ， 我 们 
要 介绍 部 署 网 站 时 需要 做 些 什 么 。 

















有 用 的 TDD 概念 和 经 验 法 则 

。 测试 隔离 和 全 局 状态 
不 同 的 测试 之 间 不 能 彼此 影响 ， 也 就 是 说 每 次 测试 结束 后 都 要 还 原 所 做 的 永久 性 操 
作 。Django 的 测试 运行 程序 可 以 帮助 我 们 创建 一 个 测试 数据 库 ， 每 次 测试 结束 后 部 
会 清空 数据 库 (详情 参见 第 19 章 ) 。 

。 从 一 个 可 运行 状态 到 男 一 个 可 运行 状态 (又 叫 测试 山羊 与 重 构 猫 ) 
本 能 经 常 驱使 我 们 直接 动手 一 次 修正 所 有 问题 ， 但 如 果 不 小 心 ， 最 
一 样 ， 改 动 了 很 多 代码 但 者 不 起 作用 。 测 试 山羊 建 议 我 们 一 次 只 到 
运行 状态 走 到 另 一 个 可 运行 状态 。 


终 可 能 像 重 构 猫 
步 ， 从 一 个 可 


。 YAGNI 
“You ain’t gonna need it” (你 不 需要 这 个 ) 的 简称 ， 劝 诚 你 不 要 受 族 惑 编写 当时 看 
起 来 可 能 有 用 的 代码 。 很 有 可 能 你 根本 用 不 到 这 些 代 码 ， 或 者 没有 准确 预见 未 来 的 
需求 。 第 18 章 给 出 了 一 种 方法 ， 可 以 让 你 避免 落 入 这 个 陷阱 。 
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第 二 部 分 


Web 开发 要 素 





“真正 的 开发 者 一 定 会 发 布 自己 的 产品 。 
Jeff Atwood 





如 果 这 是 一 本 普通 编程 领域 内 的 TDD 入 门 书 ， 到 这 里 我 们 就 可 以 庆贺 一 番 了 ， 毕 竟 我 们 
已 经 掌握 了 扎实 的 TDD 和 Django 基础 ， 也 具备 了 开始 开发 网 站 所 需 的 一 切 知识 。 








但 是 ， 真正 的 开发 者 一 定 会 发 布 自己 的 产品 ， 对 Web 开发 中 一 些 环 手 问题 就 无 法 回避 。 如 
静态 文件 、 表 单数 据 验证 、 可 怕 的 JavaScript 等 ， 但 最 令 人 惧怕 的 还 是 部 署 到 生产 服务 器 。 


在 每 个 阶段 ，TDD 都 能 协助 我 们 正确 处 理 这 些 问题 。 





在 这 一 部 分 中 ， 我 仍 会 尽量 让 学 习 曲 线 保持 平缓 ， 而 且 我 们 会 学 到 多 个 重要 的 新 概念 和 技 
术 。 我 不 会 深入 展开 每 个 话题 ， 只 是 希望 我 所 演示 的 方法 足够 你 在 自己 的 项 目 中 开始 使 
用 。 如 果真 想 在 实际 工作 中 使 用 这 些 技术 ， 你 还 得 做 些 扩 展 阅 读 。 





如 果 你 开始 阅读 本 书 之 前 并 不 熟悉 Django， 现 在 花 点 时 间 读 一 遍 Django 官方 教程 ， 能 很 
好 地 巩固 目前 所 学 的 知识 。 熟 悉 Django 的 相关 概念 后 ， 你 会 更 自信 ， 在 接 下 来 的 几 章 中 ， 
能 专注 于 我 要 讲 的 核心 概念 。 


这 一 部 分 有 很 多 有 趣 的 知识 ， 敬 请 期 待 ! 
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第 7 章 
美化 网 站 ， 布局、 样式 
及 其 测试 方法 





我 们 正 考虑 要 发 布 网 站 的 第 一 个 版 本 ， 但 让 大 尴 众 的 是 ， 网 站 现在 看 起 来 还 很 简陋 。 本 章 
介绍 一 些 样 式 基础 知识 ， 包 括 如 何 集成 Bootstrap 这 个 HTML/CSS 框架 ， 还 要 学 习 Django 
处 理 静 态 文 件 的 方式 ， 以 及 如 何 测试 静态 文件 。 


7.1 如 何在 功能 测试 中 测试 布局 和 样式 


不 可 和 否认， 我 们 的 网 站 现在 没有 太 多 的 吸引 力 (如 图 7-1)。 





执行 命令 manage.py runserver 启动 开发 服务 器 时 ， 可 能 会 看 到 一 个 数据 库 
错误 :“table lists_item has no column named list_id” (lists_item 表 中 没有 名 为 
list_id 的 列 )。 此 时 ， 需 要 执行 manage.py migrate 命令 ， 更 新 本 地 数据 库 ， 
让 models.py 中 的 改动 生效 。 








既然 不 参加 Python 世界 的 选 丑 竞赛 (http://grokcode.com/746/dear-python-why-are-you-so- 
ugly/)， 就 要 美化 这 个 网 站 。 或 许 我 们 想 实现 如 下 效果 : 


。 一 个 精美 且 很 大 的 输入 框 ， 用 于 新 建 清 单 ， 或 者 把 待 办 事项 添加 到 现 有 的 清单 中 ， 
。 把 这 个 输入 框 放 在 一 个 更 大 的 居中 框 体 中 ， 吸 引用 户 的 注意 力 。 
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应 该 怎么 使 用 TDD 实现 这 些 效果 呢 ? 大 多 数 人 都 会 告诉 你 ， 不 要 测试 外 观 。 他 们 是 对 的 ， 
这 就 像 是 测试 常量 一 样 之 无 意义 。 





-oo To-Do lists- Mozilla Firefox 
ITo-Do lists [时 | 


所 localhost -@| | 图 coo' Q 4 合 hr 


Start a To-Do list 


国共 Se® 











7-1: 首页 ， 有 点 简陋 


但 可 以 测试 装饰 外 观 的 方式 ， 确 信和 实现 了 预期 的 效果 即 可 。 例 如 ， 使 用 层 倒 样式 表 
(Cascading Style Sheet，CSS) 编写 样式 ， 样 式 表 以 静态 文件 的 形式 加 载 ， 而 静态 文件 配置 
起 来 有 点 儿 复 杂 ( 稍 后 会 看 到 ， 把 静态 文件 移 到 主机 上 ， 配 置 起 来 更 麻烦 )， 因 此 只 需 做 
某 种 “ 冒 烟 测 试 ”(smoke test) ， 确 保 加 载 了 CSS 即 可 。 无 须 测 试 字体 、 颜 色 以 及 像素 级 
位 置 ， 而 是 通过 简单 的 测试 ， 确 认 重 要 的 输入 框 在 每 个 页 面 中 都 按照 预期 的 方式 对 齐 ， 由 
此 推断 页 面 中 的 其 他 样式 或 许 也 都 正确 应 用 了 。 


先 在 功能 测试 中 编写 一 个 新 测试 方法 : 









































functional tests/tests.py (ch07I1001) 


class NewVisitorTest(LiveServerTestCase): 


ER] 


def test layout and_styling(self): 
# 伊 迪 丝 访问 首页 
seLf .browser .get(seLf.Live_server_UrL) 
self.browser.set_window_size(1024, 768) 























# 她 看 到 输入 框 完美 地 居中 显示 
inputbox = self.browser.find element_ by_id('id new item') 
self.assertAlmostEqual( 
inputbox.location['x'] + inputbox.size[ 'width'] / 2， 
512， 
delta=5 
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这 里 有 些 新 知识 。 先 把 浏览 器 的 窗口 设 为 固定 大 小 ， 然 后 找到 输入 框 元素 ， 获 取 它 的 大 小 
和 位 置 ， 再 做 些 数学 计算 ,检查 输入 框 是否 位 于 网 页 的 中 线 上 。assertAlmostEqual 的 作用 
是 帮助 处 理 舍 入 误差 ， 这 里 指定 计算 结果 在 正 负 五 像素 范围 内 为 可 接受 。 


运行 功能 测试 会 得 到 如 下 结果 : 








$ python3 manage.py test functional_tests 
Creating test database for alias 'default'... 


Traceback (most recent call last): 
File "/workspace/superlists/functional_tests/tests.py", line 104, in 
test_layout_and_styling 
delta=5 
AssertionError: 110.0 != 512 within 5 delta 


Ran 2 tests in 9.188s 


FAILED (failures=1) 
Destroying test database for alias 'default'... 











这 次 失败 在 预料 之 中 。 不 过 ， 这 种 功能 测试 很 容易 出 错 ， 所 以 要 用 一 种 有 点 作 涵 的 快捷 方法 
确认 输入 框 居 中 时 功能 测试 能 通过 。 一 旦 确认 功能 测试 编写 正确 之 后 ， 就 把 这 些 代码 删 掉 





lists/templates/home.html (ch071002) 


<form method="POST" action="/lists/new"> 
<p style="text-align: center;"> 
<input name="item text" id="id new_item" placeholder="Enter a to-do item" /> 
</p> 
{% csrf_token %} 
</form> 





修改 之 后 测试 能 通过 ， 说 明 功 能 测试 起 作用 了 。 下 面 扩 展 这 个 测试 ， 确 保 新 建 清单 后 输入 
框 仍然 居中 对 齐 显示 : 














functional tests/tests.py (ch071003) 





# 她 新 建 了 一 个 清单 ,看 到 输入 框 仍 完美 地 居中 显示 
inputbox.send_keys('testing\n') 
inputbox = self.browser.find element_ by_id('id new item') 
self.assertAlmostEqual( 
inputbox.location['x'] + inputbox.size[ 'width'] / 2， 
512， 
delta=5 





) 
这 会 导致 测试 再 次 失败 : 




















File "/workspace/superlists/functional_tests/tests.py", line 114, in 
test_layout_and_styling 
delta=5 
AssertionError: 110.0 != 512 within 5 delta 


$ git add functional_tests/tests.py 
$ git commit -m "first steps of FT for layout + styling" 


现在 ， 似 乎 找到 了 满足 需求 的 适当 解决 方案 ， 能 更 好 地 样式 化 网 站 。 那 么 就 退回 添加 
<p style="text-align: center"> 之 前 的 状态 吧 


$ git reset --hard 


git reset --hard 是 一 个 破坏 力 极 强 的 Git 命令 ， 它 会 还 原 所 有 没 提交 的 改 
动 ， 所 以 使 用 时 要 小 心 。 它 和 几乎 所 有 其 他 Git 命令 都 不 同 ， 执行 之 后 无 法 
撤销 操作 。 








7.2 ”使 用 CSS 框 架 美化 网 站 


设计 不 简单 ， 现 在 更 难 ， 因 为 要 处 理 手 机 、 平 板 等 设备 。 所 以 很 多 程序 员 ， 尤 其 是 像 我 一 
样 的 懒 人 ， 都 转 而 使 用 CSS 框架 解决 问题 。 框 架 有 很 多 ， 不 过 出 现 最 早 且 最 受 欢 迎 的 是 
Twitter 开发 的 Bootstrap。 我 们 就 使 用 这 个 框架 。 






































Bootstrap 可 在 http://getbootstrap.com/ 获取 。 


下 载 Bootsttap， 把 它 放 在 Lists 应 用 中 一 个 新 文件 夹 static 里 : 





$ wget -0 bootstrap.zip https://github.com/twbs/bootstrap/reLeases/downLoad 八 
v3.1.0/bootstrap-3.1.0-dist.zip 

$ unzip bootstrap.zip 

$ mkdir lists/static 

$ mv dist lists/static/bootstrap 

$ rm bootstrap.zip 


dist 文件 夹 中 的 内 容 是 未 经 定制 的 原始 Bootstrap 框架 ， 现 在 使 用 这 些 内 容 ， 但 在 真正 
的 网 站 中 不 能 这 么 做 ， 因 为 用 户 能 立即 看 出 你 使 用 Bootstrap 时 没有 定制 ， 业 内 人 士 
也 能 由 此 推 知 你 懒得 为 网 站 编写 样式 。 你 应 该 学 习 如 何 使 用 LESS， 至 少 把 字体 改 了 。 
Bootstrap 文档 中 有 定制 的 详细 说 明 ， 或 者 你 可 以 阅读 这 篇 写 得 不 错 的 指南 (http://www. 
smashingmagazine.com/2013/03/12/customizing-bootstrap/) 。 

















注 1: 在 Windows 中 不 能 使 用 wget 和 unzip， 但 我 相信 你 知道 如 何 下 载 Bootstrap， 解 压缩 ， 再 把 dist 文件 夹 
中 的 内 容 移 到 lists/static/bootstrap 文件 夹 中 。 
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最 终 得 到 的 lists 文件 夹 结构 如 下 : 


$ tree lists 
lists 
HF _init_ .py 
__Ppycache__ 
= 
dmin.py 
odels.py 
tatic 
一 一 bootstrap 
-一 css 
上 一 bootstrap.css 
一 bootstrap.css.map 
一 bootstrap.min.css 
| 一 bootstrap-theme.css 
一 bootstrap-theme.css.map 
上 -一 bootstrap-theme.min.css 
-一 fonts 
| 一 glyphicons-halflings-regular.eot 
一 glyphicons-halflings-regular.svg 
| 一 glyphicons-halflings-regular.ttf 
-一 gLyphicons-haLfLings-reguLar .woff 
[一 js 
一 bootstrap.js 
上 -一 bootstrap.min.js 


i 


Wn3o 








| 一 tempLates 

上 一 home .htmL 
[一 list.html 
一 tests.py 

FE urLs.py 


一 一 views.py 





在 Bootstrap 文档 中 的 “Getting Started” 部 分 (http://twitter.github.io/bootstrap/getting-started. 
html#html-template) ， 你 会 发 现 Bootstrap 要 求 HTML 模板 中 包含 如 下 代码 : 


<!DOCTYPE htmL> 
<htmL> 
<head> 
<title>Bootstrap 101 Template</title> 
<meta name="viewport" content="width=device-width, initial-scale=1.0"> 


<!-- Bootstrap --> 

<Link href="css/bootstrap.min.css" rel="stylesheet" media="screen"> 
</head> 
<body> 


<hi>Hello, world!</h1i> 
<script src="http://code.jquery.com/jquery.js"></script> 
<script src="js/bootstrap.min.js"></script> 
</body> 
</html> 





我 们 已 经 有 两 个 HTML 模板 了 ， 所 以 不 想 在 每 个 模板 中 都 添加 大 量 的 样板 代码 。 这 似乎 是 
运用 “不 要 自我 重复 ” ee 可 以 把 通用 代码 放 在 一 起 。 谢 天 谢 地 ，Django 使 用 
的 模板 语言 可 以 轻易 做 到 这 一 点 ， 这 种 功能 叫 作 “模板 继承 ”。 











| 大 
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7.3 Django 模板 继承 
看 一 下 home.html 和 list.html 之 间 的 差异 : 


$ diff lists/templates/home.html lists/templates/list.html 


7,8c7,8 

< <h1>Start a new To-Do List</h1> 

< <form method="POST" action="/lists/new"> 

> <h1>Your To-Do List</h1> 

> <form method="POST" action="/lists/{{ list.id }}/add_item"> 
11a12 ,18 

> 

> <table id="id_list_table"> 

> {% for item in list.item set.all %} 

> <tr><td>{{ forloop.counter }}: {{ item.text }}</td></tr> 
> {% endfor %} 

> </table> 

> 


这 两 个 模板 头 部 显示 的 文本 不 一 样 ， 而 且 表 单 的 提交 地 址 也 不 同 。 除 此 之 外 ，listhtml 还 
多 了 一 个 <table> 元 素 。 

现在 我 们 弄 清 了 两 个 模板 之 间 共 通 以 及 有 差异 的 地 方 ， 然 后 就 可 以 让 它们 继承 同一 个 父 级 
模板 了 。 先 复制 home.html: 








$ cp Lists/tempLates/home.htmL lists/templates/base.html 
把 通用 的 样板 代码 写 入 这 个 基 模 板 中 ， 而 且 标 记 出 各 个 “ 块 "， 块 中 的 内 容留 给 子 模板 定制 |: 


lists/templates/base.html 


<html> 
<head> 

<title>To-Do lists</title> 
</head> 


<body> 
<h1i>{% block header_text %}{% endblock %}</hi> 
<form method="POST" action="{% block form action %}{% endblock %}"> 
<input name="item text" id="id new_item" placeholder="Enter a to-do item" /> 
{% csrf_token %} 
</form> 
{% block table %} 
{% endblock %} 
</body> 
</html> 





基 模 板 定义 了 多 个 叫 作 “ 块 ”的 区 域 ， 其 他 模板 可 以 在 这 些 地 方 插入 自己 所 需 的 内 容 。 在 
实际 操作 中 看 一 下 这 种 机 制 的 用 法 。 修 改 home.html， 让 它 继承 base.html: 
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lists/templates/home.html 
{% extends 'base.html' %} 


{% block header_text %}Start a new To-Do list{% endblock %} 


{% block form action %}/lists/new{% endblock %} 


可 以 看 出 ， 很 多 HTML 样板 代码 都 不 见 了 ， 只 需 集 中 精力 编写 想 定 制 的 部 分 。 然 后 对 list. 
html 做 同样 的 修改 : 








lists/templates/list.html 
{% extends 'base.html' %} 


{% block header_text %}Your To-Do list{% endblock %} 
{% block form action %}/lists/{{ list.id }}/add_ item{% endblock %} 


{% block table %} 
<table id="id list_table"> 
{% for item in list.item set.all %} 
<tr><td>{{ forloop.counter }}: {{ item.text }}</td></tr> 
{% endfor %} 
</table> 
{% endblock %} 


对 模板 来 说 ， 这 是 一 次 重 构 。 再 次 运行 功能 测试 ， 确 保 设 有 破坏 现 有 功能 
AssertionError: 110.0 != 512 within 5 delta 

有 果然， 结果 和 修改 前 一 样 。 这 次 改动 值得 做 一 次 提交 : 
$ git diff -b 
# -b 的 意思 是 忽略 空白 ,因为 我 们 修改 了 HTML 代 码 中 的 一 些 缩 进 ,所 以 有 必要 使 用 这 个 旗 标 
$ git status 


$ git add lists/templates # 人 先 不 添加 static 文 件 夹 
$ git commit -m"refactor templates to use a base template" 


7.4 集成 Bootstrap 
现在 集成 Bootstrap 所 需 的 样板 代码 更 容易 了 ， 不 过 和 暂时 不 需要 JavaScript， 只 加 入 CSS 即 可 : 












































lists/templates/base.html (ch071006) 


<!DOCTYPE htmL> 
<html lang="en"> 


<head> 
<title>To-Do lists</title> 
<meta name="viewport" content="width=device-width, initial-scale=1.0"> 
<link href="css/bootstrap.min.css" rel="stylesheet" media="screen"> 
</head> 


[ta] 





， 使 用 Bootstrap 中 某 些 真正 强大 的 功能 。 使 用 之 前 你 得 先 阅读 Bootstrap 的 文档 。 可 
We text-center 类 实现 所 需 的 效果 ; 





lists/templates/base.html (ch071007) 


<body> 
<div class="container"> 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
<div class="text-center"> 
<h1>{% block header_text %}{% endblock %}</h1i> 
<form method="POST" action="{% block form_action %}{% endblock %}"> 
<input name="item text" id="id new_item" 
placeholder="Enter a to-do item" 
/> 
{% csrf_token %} 
</form> 
</div> 
</div> 
</div> 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
{% block table %} 
{% endblock %} 
</div> 
</div> 


</div> 
</body> 


(如 果 你 从 来 没有 把 一 个 HTML 标签 分 成 多 行 ， 可 能 会 觉得 上 述 <input> 标签 有 点 儿 打 破 
常规 。 这 样 写 完全 可 行 ， 如 果 你 不 喜欢 ， 可 以 不 这 么 写 。) 





如 果 你 从 未 看 过 Bootstrap 文档 (http:Wgetbootstrap.com/) ， 花 点 儿 时 间 浏 览 
一 下 吧 。 文 档 中 介绍 了 很 多 有 用 的 工具 ， 可 以 运用 到 你 的 网 站 中 。 








做 了 上 述 修改 之 后 ， 功 能 测试 能 通过 吗 ? 
AssertionError: 110.0 != 512 within 5 delta 


不 能 。 为 什么 没有 加 载 CSS 呢 ? 
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7.5 Django 中 的 静态 文件 


Django 处 理 静态 文件 时 需要 知道 两 件 事 〈 其 实 所 有 Web 服务 器 都 是 如 此 ) : 





























() 收 到 指向 某 个 URL 的 请 求 时 ， 如 何 区 分 请 求 的 是 静态 文件 ， 还 是 需要 经 过 视图 函数 处 
理 ， 生 成 HTML; 











(2) 到 哪里 去 找 用 户 请 求 的 静态 文件 。 
其 实 ， 静 态 文件 就 是 把 URL 映射 到 硬盘 中 文件 上 。 




















为 了 解决 第 一 个 问题 ，Django 允许 我 们 定义 一 个 URL 前 组 ， 任 何以 这 个 前 缀 开头 的 URL 
都 被 视 作 针 对 静态 文件 的 请 求 。 默 认 的 前 级 是 /static/， 在 settings.py 中 定义 : 





superlists/settings.py 
Es 


# Static files (CSS, JavaScript, Images) 
# https://docs.djangoproject.com/en/1.7/howto/static-files/ 


STATIC_URL = '/static/' 








后 面 在 这 一 部 分 添加 的 设置 都 和 第 二 个 问题 有 关 ， 即 在 硬盘 中 找到 真正 的 静态 文件 。 




















既然 用 的 是 Django 开发 服务 器 (manage.py runserver)， 就 可 以 把 寻找 静态 文件 的 任务 交 
给 Django 完成 。Django 会 在 各 应 用 中 每 个 名 为 static 的 子 文件 夹 里 寻找 静态 文件 。 











现在 知道 把 Bootstrap 框架 的 所 有 静态 文件 都 放 在 lists/static 文件 夹 中 的 原因 了 吧 。 可 是 为 
什么 现在 不 起 作用 呢 ? 因为 没 在 URL 中 加 入 前 级 /static/。 再 看 一 下 base.html 中 链接 
CSS 的 元 素 : 




















lists/templates/base.html 


<link href="css/bootstrap.min.css" rel="stylesheet" media="screen"> 
若 想 让 这 行 代码 起 作用 ， 要 把 它 改 成 : 


lists/templates/base.html 


<link href="/static/bootstrap/css/bootstrap.min.css" rel="stylesheet" 
media="screen"> 





现在 ， 开 发 服务 器 收 到 这 个 请 求 时 就 知道 请 求 的 是 静态 文件 ， 因 为 URL 以 /static/ 开头 。 
然后 ， 服 务 器 在 每 个 应 用 中 名 为 static 的 子 文件 夹 里 搜寻 名 为 bootstrap/css/bootstrap. 
min.css 的 文件 。 最 后 找到 的 文件 应 该 是 lists/static/bootstrap/css/bootstrap.min.css。 














如 果 和 手动 在 浏览 器 中 查看 ， 应 该 会 看 到 样式 起 作用 了 ， 如 图 7-2 所 示 。 








A 
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国 - D To-Do lists- Mozilla Firefox 
|EiTo-Dolists [号 | 
《 localhost -@| 图 - gle Q 业 合 Lr 


Your To-Do list 
1: Download bootstrap 
2: Explain static files 


3: Take a screenshot 
4: Finish chapter 7 


加 * 9 








图 7-2: 网 站 开始 变 得 有 点 好 看 了 


ee 
不 过 ， 功 能 测试 还 无 法 通 


AssertionError: 110.0 != 512 within 5 delta 


这 是 因为 ， 虽 然 runserver 启动 的 开发 服务 器 能 自动 找到 静态 文件 但 
LiveServerTestCase 找 不 到 。 不 过 无 需 担 心 ，Django 为 开发 者 提供 了 一 个 更 神奇 的 测试 


类 ， 了 叫 staticLiveServerCase ”。 








下 面 换 用 这 个 测试 类 : 











functional tests/tests.py 
QQ -1,8 +1,8 QQ 
-from django.test import LiveServerTestCase 
+from django.contrib.staticfiles.testing import StaticlLiveServerCase 
from selenium import webdriver 
from selenium.webdriver .common.keys import Keys 


-Class NewVisitorTest(LiveServerTestCase): 
+CLass NewVisitorTest(StaticLiveServerCase): 


现在 测试 能 找到 CSS 了， 因此 测试 也 能 通过 了 : 











注 2: 参见 文档 : https://docs.djangoproject.com/en/1.7/howto/static-files/#staticfiles-testing-support。 
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$ python3 manage.py test functional_tests 
Creating test database for alias 'default'... 


Ran 2 tests in 9.764s 


Windows 用 户 在 这 里 可 能 会 看 到 一 些 错误 消息 (无 关 紧 要 ， 但 容易 让 人 分 心 ) : 
socket.error: [WinError 10054] An existing connection was forcibly closed 
by the remote host ( 现 有 连接 被 远程 主机 强制 关闭 )。 在 tearDown 方法 的 self. 
browser .quit() 之 前 加 上 self.browser.refresh() 就 能 去 掉 这 些 错误 。Django 的 
追踪 系统 正在 关注 这 个 问题 (https://code.djangoproject.com/ticket/21227)。 











太 好 了 ! 


7.6 使 用 Bootstrap 中 的 组 件 改 进 网 站 外 观 


看 一 下 使 用 Bootstrap 百宝箱 中 的 其 他 工具 能 否 进一步 改善 网 站 的 外 观 。 


7.6.1 超大 文本 块 


Bootstrap 中 有 个 类 叫 jumbotron， 用 于 特别 突出 地 显示 页 面 中 的 元 素 。 使 用 这 个 类 放大 显 
示 页 面 的 主 头 部 和 输入 表单 : 


lists/templates/base.html (ch071009) 


<div class="col-md-6 col-md-offset-3 jumbotron"> 
<div class="text-center"> 
<h1>{% block header_text %}{% endblock %}</hi> 
<form method="POST" action="{% block form_action %}{% endblock %}"> 
Ez] 


调整 网 页 的 设计 和 布局 时 ， 可 以 打开 一 个 浏览 器 窗口 ， 时 不 时 地 刷新 页 面 。 
执行 python3 manage.py runserver 命令 启动 开发 服务 器 ， 然 后 在 浏览 器 中 访 
问 http:/Wlocalhost:8000， 边 改 边 看 效果 。 




















7.6.2 ”大 型 输入 框 


超大 文本 块 是 个 好 的 开始 ， 不 过 和 其 他 内 容 相 比 ， 输 入 框 显得 太 小 。 幸 好 Bootstrap 为 表单 
控件 提供 了 一 个 类 ， 可 以 把 输入 框 变 大 : 











lists/templates/base.html (ch071010) 


<input name="item text" id="id new_item" 
class="form-control input-lg" 
placeholder="Enter a to-do item" 


/> 
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7.6.3 样式 化 表格 


现在 表格 中 的 文字 和 页 面 中 的 其 他 文字 相 比 也 很 小 ， 加 上 Bootstrap 提供 的 table 类 可 以 改 
进 显 示 效 果 : 


























lists/templates/list.html (ch071011) 
<table id="id list table" class="table"> 


7.7 ”使 用 自己 编写 的 CSS 


最 后 ， 我 想 让 输入 表单 离 标题 文字 远 一 点 儿 。Bootstrap 没有 提供 现成 的 解决 方案 ， 那 么 就 
自己 实现 吧 ， 引 入 一 个 自己 编写 的 CSS 文件 : 








lists/templates/base.html 


<head> 
<title>To-Do lists</title> 
<meta name="viewport" content="width=device-width, initial-scale=1.0"> 
<Link href="/static/bootstrap/css/bootstrap.min.css" rel="stylesheet" media="screen"> 
<link href="/static/base.css" rel="stylesheet" media="screen"> 
</head> 





新 建文 件 lists/static/base.css， 写 入 自己 编写 的 CSS 新 规则 。 使 用 输入 框 的 id (id_new_item) 
定位 元 素 ， 然 后 为 其 编写 样式 : 


























lists/static/base.css 


#id new_item { 
margin-top: 2ex; 


} 
虽然 要 多 操作 几 步 ， 不 过 效果 很 让 我 满意 (如 图 7-3)。 


如 果 想 进一步 定制 Bootstrap， 需 要 编译 LESS。 我 强烈 推荐 你 花 时 间 定 制 ， 总 有 一 天 你 会 
有 这 种 需求 。LESS、SCSS 等 其 他 伪 CSS 类 工具 ， 对 普通 的 CSS 做 了 很 大 改进 ， 即 便 不 
使 用 Bootstrap 也 很 有 用 。 我 不 会 在 这 本 书 中 介绍 LESS， 网 上 有 很 多 参考 资料 ， 比 如 说 这 
个 http://www.smashingmagazine.com/2013/03/12/customizing-bootstrap/。 


最 后 再 运行 一 次 功能 测试 ， 看 一 切 是 否 仍 能 正常 运行 : 























$ python3 manage.py test functionaL_tests 
Creating test database for alias 'default'... 


Ran 2 tests in 10.084s 


OK 
Destroying test database for alias 'default'... 
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To-Do lists - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 
|EiTo-Dolists [ 叶 | 
《 localhost "@ 图 QQ 时 合式 
四 To-Do list 
1: Collect chapters of TDD book 
i 
3: Profit! 
@O- x S99 








图 7-3: 清单 页 面 ， 各 部 分 都 显示 得 很 大 
样式 化 暂 告 段落 。 现 在 是 提交 的 绝 好 时 机 ， 


$ git status # 修改 了 tests.py.base.htmL 和 List.htmL, 未 跟踪 Ltsts/static 
$ git add . 
$ git status # 会 显示 添加 了 所 有 Bootstrap 相 关 文 件 


$ git commit -m"Use Bootstrap to improve layout" 








7.8 补遗 : collectstatic 命 令 和 其 他 静态 目录 


前 文 说 过 ，Django 的 开发 服务 器 会 自动 在 应 用 的 文件 夹 中 查找 并 呈现 静态 文件 。 在 开发 
过 程 中 这 种 功能 不 错 ， 但 在 真正 的 Web 服务 器 中 ， 并 不 需要 让 Django 伺服 静态 内 容 ， 因 
为 使 用 Python 伺服 原始 文件 速度 慢 而 且 效 率 低 ，Apache、Nginx 等 Web 服务 器 能 更 好 
地 完成 这 项 任务 。 或 许 你 还 会 决定 把 所 有 静态 文件 都 上 传 到 CDN (Content Distribution 
Network， 内 容 分 发 网 络 )， 不 放 在 自己 的 主机 中 。 


鉴于 此 ， 要 把 分 散在 各 个 应 用 文件 夹 中 的 所 有 静态 文件 集中 起 来 ， 复 制 一 份 放 在 一 个 位 
置 ， 为 部 署 做 好 准备 。collectstatic 命令 的 作用 就 是 完成 这 项 操作 。 
静态 文件 集中 放置 的 位 置 由 settings.py 中 的 STATIC_RooT 定义 。 下 一 章 会 做 些 部 署 工作 ， 


现在 就 试 着 设置 一 下 吧 。 把 STATIC_ROOT 的 值 设 为 仓库 之 外 的 一 个 文件 夹 一 一 我 要 使 用 和 
主 源码 文件 夹 同 级 的 一 个 文件 夹 : 












































workspace 
六 一 superlists 
FF 一 Lists 
一 modeLs.py 


上 一 manage.py 
FF- 一 superlists 


广 一 static 
六 一 base.css 
六 一 etc... 














关键 在 于 ， 静 态 文件 所 在 的 文件 夹 不 能 放 在 仓库 中 
因为 其 中 的 文件 和 lists/static 中 的 一 样 。 





不 想 把 这 个 文件 夹 纳 入 版 本 控制 ， 











下 面 是 指定 这 个 文件 夹 位 置 的 一 种 优雅 方式 ， 路 径 相 对 settings.py 文件 而 言 : 











superlists/settings.py (ch071018) 


# Static files (CSS, JavaScript, Images) 
# https://docs.djangoproject.com/en/1.7/howto/static-files/ 


STATIC_URL = '/static/' 
STATIC_ROOT = os.path.abspath(os.path.join(BASE DIR, '../static')) 





在 设置 文件 的 顶部 ， 你 会 看 到 定义 了 BASE_DIR 变量 。 这 个 变量 提供 了 很 大 的 帮助 。 下 面 执 
行 collectstatic 命令 试 试 : 














$ python3 manage.py collectstatic 


You have requested to collect static files at the destination 
location as specified in your settings: 


/workspace/static 


This will overwrite existing files! 
Are you sure you want to do this? 


Type 'yes' to continuye, or 'no' to cancel: 
yes 


Es 
Copying '/workspace/superlists/lists/static/bootstrap/fonts/glyphicons-halfling 
s-regular .svg' 


74 static files copied to '/workspace/static'. 
如 果 查 看 ../static， 会 看 到 所 有 的 CSS 文件 : 


$ tree ../static/ 


../static/ 








美化 网 站 : 布局 、 样 式 及 其 测试 方法 | 119 


一 admin 





| 一 css 
| 一 base.css 
[...] 
-一 urlify.js 
一 base.css 
一 一 bootstrap 
| 一 css 
-一 bootstrap.css 
广 一 bootstrap.min.css 
广 一 bootstrap-theme.css 
一 一 bootstrap-theme.min.css 
一 fonts 


— glyphicons-halflings-regular.eot 
— glyphicons-halflings-regular.svg 
— glyphicons-halflings-regular.ttf 
-一 gLyphicons-haLfLings-reguLar .woff 
[一 js 
-一 bootstrap.js 
一 一 bootstrap.min.js 








10 directories, 74 files 

















collectstatic 命令 还 收集 了 管理 后 台 的 所 有 CSS 文件 。 管 理 后 台 是 Django 的 强大 功能 
一 ， 总 有 一 天 我 们 要 知道 它 的 全 部 功能 。 但 现在 还 不 准备 用 ， 所 以 暂且 禁用 : 











superlists/settings.py 


INSTALLED_APPS = ( 
#'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
"django.contrib.messages ' ， 
'django.contrib.staticfiles', 
'lists', 


) 
然后 再 执行 coLLectstatic 试 试 : 


$ rm -rf ../static/ 

$ python3 manage.py collectstatic --noinput 

Copying '/workspace/superlists/lists/static/base.css’ 

Copying '/workspace/superlists/lists/static/bootstrap/js/bootstrap.min.js' 
Copying '/workspace/superlists/lists/static/bootstrap/js/bootstrap.js' 


[...] 


13 static files copied to '/workspace/static'. 


好 多 了 。 





总 之 ， 现 在 知道 了 怎么 把 所 有 静态 文件 都 聚集 到 一 个 文件 夹 中 ， 这 样 Web 服务 器 就 能 轻易 
找到 静态 文件 。 下 一 章 会 深入 介绍 这 个 功能 和 测试 方法 。 





现在 ， 先 提交 settings.py 中 的 改动 : 





$ git diff # 会 看 到 settings.py 中 的 改动 
$ git commit -am"set STATIC_ROOT in settings and disable admin" 


7.9 没 谈 到 的 话题 

本 章 只 简单 介绍 了 样式 化 和 CSS， 有 一 些 话题 我 本 想 深 入 探讨 ， 但 没 做 到 。 你 可 以 进一步 
研究 以 下 话题 : 

。 使 用 LESS 定制 Bootstrap; 

。 使 用 { static %} 模板 标签 ， 这 样 做 更 符合 DRY 原则 ， 也 不 用 硬 编码 URL; 
客户 端 打包 工具 ， 例 如 bower。 








简单 来 说 ， 不 应 该 为 设计 和 布局 编写 测试 。 因 为 这 太 像 是 测试 常量 ， 所 以 写 出 的 测试 
不 太 牢 靠 。 

这 说 明 设 计 和 布局 的 实现 过 程 极 具 技 巧 性 ， 涉 及 CSS 和 静态 文件 。 因 此 ， 可 以 编写 一 
些 简 单 的 “ 冒 烟 测试 ”， 确 认 静 态 文件 和 CSS 起 作用 即 可 。 下 一 章 我 们 会 看 到 ， 把 代 
码 部 署 到 生产 环境 时 ， 置 烟 测试 能 协助 我 们 发 现 问题 。 

但 是 ， 如 果 某 部 分 样式 需要 很 多 客户 六 JavaScript 代码 才能 使 用 (我 花 了 很 多 时 间 实 
现 动 态 缩放 )， 就 必须 为 此 编写 一 些 测试 。 

所 以 要 记 住 ,这 是 一 个 危险 地 带 。 要 试 着 编写 最 简 的 测试 ， 确 信 设 计 和 布局 能 起 作用 
即 可 ， 不 必 测 试 具体 的 实现 。 我 们 的 目标 是 能 自由 修改 设计 和 布局 ， 且 无 需 时 不 时 地 
调整 测试 。 
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第 8 和 章 


使 用 过 渡 网 站 测试 部 团 





“所 有 乐趣 都 在 部 署 到 生产 环境 之 前 。” 
Devops Borat (https://twitter.com/DEVOPS_BORAT/status/192271992253190144) 





是 时 候 发 布 网 站 的 首 个 版 本 让 公众 使 用 了 。 人 们 常 说 ， 如 果 等 到 一 切 就 绪 再 发 布 ， 等 待 的 
时 间 就 太 长 了 。 


我 们 的 网 站 有 用 吗 ? 是 不 是 比 没有 要 好 ?能 在 这 个 网 站 上 创建 待 办 事项 清单 吗 ? 这 三 个 疑 
问 的 答案 都 是 肯定 的 。 


可 是 ， 现 在 还 无 法 登录 ， 也 无 法 把 任务 标记 为 已 完成 。 不 过 你 真 的 需要 这 些 功 能 吗 ? 不 一 
定 ， 因 为 你 永远 也 不 知道 用 户 真正 想 使 用 你 的 网 站 做 什么 。 我 们 觉得 用 户 应 该 想 使 用 这 个 
网 站 制定 待 办 事项 清单 ， 但 他 们 真正 想 编 写 的 或 许 是 一 个 “十 佳 假 晶 钓鱼 地 ”列表 ， 因 此 
就 不 用 提供 “标记 为 已 完成 ”功能 。 在 发 布 之 前 ， 我 们 永远 不 知道 用 户 的 真实 需求 。 

















本 章 会 详细 介绍 如 何 把 网 站 部 署 到 真实 的 线 上 Web 服务 器 中 。 

你 可 能 想 跳 过 这 一 章 ， 因 为 本 章 有 很 多 令 人 生长 的 知识 ， 或 许 还 觉得 部 署 不 是 你 阅读 本 书 
的 初 囊 。 但 是 我 强烈 建议 你 读 一 下 。 本 章 是 我 最 满意 的 音 市 之 一 ， 而 且 有 很 多 读者 写 信 说 
很 庆幸 自己 当时 克服 困难 读 完 了 这 一 章 。 























如 有 果 你 以 前 从 未 把 网 站 部 署 到 服务 器 上 ， 读 过 本 章 后 会 发 现 一 片 新 大 陆 ， 而 且 设 有 什么 能 
比 看 到 自己 的 网 站 在 真正 的 互联 网 中 上 线 更 令 人 满足 的 了 。 如 果 你 还 迟疑 ， 现 今 流 行 的 术 
语 ， 比 如 “开发 运 维 ”(DevOps)， 一 定 能 让 你 相信 ， 花 时 间 学 习 部 署 是 值得 的 。 
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尔 的 网 站 上 线 后 请 写 封 信 告 诉 我 网 址 。 收 到 这 样 的 来 信 ， 我 的 心里 总 是 感觉 
上 暧 暧 的 。 我 的 电子 邮件 地 址 是 obeythetestinggoat@gmail.com。 





8.1 TDD 以 及 部 署 的 危险 区 域 


把 网 站 部 署 到 线 上 Web 服务 器 是 个 很 复杂 的 过 程 。 我 们 经 常会 听 到 这 样 凄 苦 的 抱怨 :“ 但 
在 我 的 设备 中 可 以 正常 运行 啊 ! ” 


部 署 过 程 中 的 一 些 危险 区 域 如 下 。 














。 静态 文件 (CSS、JavaScript、 图 片 等 ) 
Web 服务 器 往往 需要 特殊 的 配置 才能 伺服 静态 文件 。 





。 数据 库 
可 能 会 遇 到 权限 和 路 径 问 题 ， 还 要 小 心 处 理 ， 在 多 次 部 署 之 间 不 能 丢失 数据 。 





























。 依赖 
要 保证 服务 器 上 安装 了 网 站 依赖 的 包 ， 而 且 版 本 要 正确 。 


不 过 这 些 问 题 都 有 相应 的 解决 方案 。 下 面 一 一 说 明 。 








。 使 用 与 生产 环境 一 样 的 基础 架构 部 署 “ 过 渡 网 站 ”(staging site)， 这 么 做 可 以 测试 部 署 
的 过 程 ， 确 保 部 署 真正 的 网 站 时 操作 正确 。 

。 可 以 在 过 渡 网 站 中 运行 功能 测试 ， 确 保 服 务 器 中 安装 了 正确 的 代码 和 依赖 包 。 而 且 为 了 
测试 网 站 的 布局 ， 我 们 编写 了 冒 烟 测 试 ， 这 样 就 能 知道 是 否 正 确 加 载 了 CSS。 

。 在 可 能 运行 多 个 Python 应 用 的 设备 中 ， 可 以 使 用 virtualenv 管理 包 和 依赖 。 

。 最 后 ， 一 切 操作 都 自动 化 完成 。 使 用 自动 化 脚本 部 署 新 版 本 ， 使 用 同一 个 脚本 把 网 站 部 
署 到 过 渡 环 境 和 生产 环境 ， 这 么 做 能 尽量 保证 过 渡 网 站 和 线 上 网 站 一 样 。， 

在 接 下 来 的 几 页 中 ， 我 会 详细 说 明 一 个 部 署 过 程 。 这 不 是 最 佳 的 部 署 过 程 ， 所 以 别 把 它 当 

做 最 佳 实践 ， 也 别 当 做 是 推荐 做 法 。 只 是 做 个 演示 ， 告 诉 你 部 署 过 程 涉及 哪些 问题 ， 以 及 

测试 在 这 个 过 程 中 的 作用 。 
































注 1: 我 称 之 为 “过 渡 ” 服 务 器 的 , 有 人 叫 它 “开发 ”服务 器 , 还 有 人 叫 它 “预备 生产 ”服务 器 。 不 管 叫 什 么 ， 
目的 都 是 架设 一 个 尽量 和 生产 服务 器 一 样 的 环境 来 测试 代码 。 
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内 容 提要 
本 章 内 容 很 多 ， 这 里 做 个 提要 ， 帮 助 你 理 清 思路 : 
1. 修改 功能 测试 ， 以 便 在 过 渡 服 务 器 中 运行 ; 


2. 架设 服务 器 ， 安 装 全 部 所 需 的 软件 ， 再 把 过 渡 和 线 上 环境 使 用 的 域名 指向 这 个 服 


3. 使 用 Git 把 代码 上 传 到 服务 器 ; 

4. 使 用 Django 开发 服务 器 在 过 渡 环 境 的 域名 下 尝试 运行 过 渡 网 站 ; 

5. 学 习 如 何在 服务 器 中 使 用 virtualenv 管理 项 目的 Python 依赖 ; 

6. 让 功能 测试 一 直 运 行 着 ， 告 诉 我 们 哪些 功能 可 以 正常 运行 哪些 不 能 

7. 使 用 Gunicorn、Upstart 和 域 套 接 字 配 置 过 渡 网 站 ， 以 便 能 在 生产 环境 中 使 用 ; 


8. 配置 好 之 后 ， 编 写 一 个 脚本 ， 自 动 执 行 前 面 手 动 完成 的 操作 ， 这 样 以 后 就 能 自动 部 
署 网 站 了 ; 


9. 最 后 ， 使 用 自动 化 脚本 把 网 站 的 生产 版 本 部 署 到 真正 的 域名 下 。 











8.2 一 如 既往 ， 先 写 测 试 


稍微 修改 一 下 功能 测试 ， 让 它 能 在 过 渡 网 站 中 运行 。 添 加 一 个 参数 ， 指 定 测试 所 用 的 临时 
服务 器 地 址 : 


functional tests/tests.py (chO8I001) 


import sys 


[aad] 
class NewVisitorTest(StaticliveServerCase): 


@classmethod 
def setUpClass(cls): #0 
for arg in sys.argv: #@ 
if 'liveserver' in arg: #@ 
cls.server_uyrl = 'http://' + arg.split('=')[1] #@ 
return #@ 
super().setUpClass() 
cls.server_uyrl = cls.live server_url 


@classmethod 
def tearDownClass(cls): 
if cls.server_url == cls.live server_url: 





super() .tearDownCLass() 


def setUp(seLf ) : 
全 
好 吧 ， 虽 然 我 说 “稍微 修改 "， 但 改动 还 是 挺 多 的 。 我 说 过 LiveServerTestCase 有 一 定 的 
缺陷 ， 还 记得 吗 ? 其 中 一 个 缺陷 是 ， 总 是 假定 你 想 使 用 它 自 己 的 测试 服务 器 。 有 时 我 确实 
想 使 用 这 个 测试 服务 器 ， 但 也 想 有 别 的 选择 ， 让 LiveserverTestCase 别 自作 多 情 ， 其 实 我 
想 使 用 一 个 真正 的 服务 器 。 
@ ”setUpClass 方法 和 setUp 类 似 ， 也 由 unittest 提供 ， 但 是 它 用 于 设 定 整个 类 的 测试 背 
景 。 也 就 是 说 ，setUpClass 方法 只 会 执行 一 次 ， 而 不 会 在 每 个 测试 方法 运行 前 都 执行 。 
LiveServerTestCase 和 StaticLiveServerCase 一 般 都 在 这 个 方法 中 启动 测试 服务 器 。 




















@ @ 在 命令 行 中 查找 参数 liveserver (从 sys.argv 中 获取 )。 
@ @ 如果 找到 了 ， 就 让 测试 类 跳 过 常规 的 setUpClass 方法 ， 把 过 渡 服 务 器 的 URL 赋值 给 


server_url 变量 


Eo 





因此 ， 还 要 修改 用 到 self.live_server_url 的 三 处 测试 代码 : 


functional tests/tests.py (c1081002) 


def test can_start a_ list and_retrieve it later(self): 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
seLf .browser .get(seLf.server_UrL) 
[i ] 

# 弗朗西斯 访问 首页 

# 页 面 中 看 不 到 伊 迪 丝 的 清单 

seLf .browser .get(seLf.server_UrL) 


[...] 












































def test layout and_styling(self): 
# 伊 迪 丝 访问 首页 
seLf .browser .get(self.server_url) 


按照 “常规 的 ”方式 运行 功能 测试 ， 确 保 上 述 改动 没有 破坏 现 有 功能 : 
$ python3 manage.py test functionaL_tests 
[iad 


Ran 2 tests in 8.544s 


OK 











然后 指定 过 渡 服 务 器 的 URL 再 运行 试 试 。 我 要 使 用 的 过 渡 服 务 器 地 址 是 superlists-staging.ottg.eu: 








$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
Creating test database for alias 'default'... 
FE 
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FAIL: test_can_start_a_List_and_retrieve_it_Later 
(functional_tests. tests.NewVisitorTest) 
Traceback (most recent call last): 

File "/workspace/superlists/functional_tests/tests.py", line 42, iin 
test_can_start a_list _and_retrieve it later 

self.assertIn('To-Do', self.browser.title) 

AssertionError: 'To-Do' not found in 'Domain name registration | Domain names 
| Web Hosting | 123-reg' 


Traceback (most recent call last): 

File 
"/workspace/superlists/functional_tests/tests.py", line 114, in 
test_layout_and_styling 

inputbox = self.browser.find element_ by_id('id new item') 

[L322] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id new item"}' ; Stacktrace: 


Ran 2 tests in 16.480s 


FAILED (failures=2) 
Destroying test database for alias 'default'... 


可 以 看 到 ， 和 预期 一 样 ， 两 个 测试 都 失败 了 ， 因 为 我 还 没 架设 过 渡 网 站 呢 。 实 际 上 ， 从 第 
一 个 调用 跟踪 中 可 以 看 出 ,访问 域名 注册 商 的 网 站 首页 时 测试 就 失败 了 。 





， 看 起 来 功能 测试 的 测试 对 象 是 正确 的 ， 所 以 做 一 次 提交 吧 


$ git diff # 会 显示 functional_tests.py 中 的 改动 
$ git commit -am "Hack FT runner to be able to test staging" 





8.3 注册 域名 


读 到 这 里 ， 我 们 需要 注册 几 个 域名 ， 不 过 


使 用 的 域名 是 superlists.ottg.eu 和 superlists-staging.ottg.eu。 如 果 你 还 没有 域名 ， 现 在 就 得 


注册 一 个 





。 再 次 说 明 ， 我 真 的 希望 你 按 我 所 说 的 做 。 如 果 你 从 未 注册 过 域名 ， 随 便 选 一 个 





老牌 注册 商 买 一 个 便宜 的 就 行 ， 只 要 花 5 美元 左右 ， 甚 至 还 能 找到 免费 域名 。 我 说 过 想 在 
真正 的 网 站 中 看 到 你 的 应 用 ， 这 或 许 能 推动 你 去 注册 一 个 域名 。 


8.4 手动 配置 托管 网 站 的 服务 器 
可 以 把 部 署 的 过 程 分 成 两 个 任务 ; 
。 配置 新 服务 器 ， 用 于 托管 代码， 
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十 也 可 以 使 用 同一 个 域名 下 的 多 个 二 级 域名 。 我 要 





。 把 新 版 代码 部 署 到 配置 好 的 服务 器 中 。 


有 些 人 喜欢 每 次 部 署 都 用 全 新 服务 器 ， 我 们 在 PythonAnywhere 就 是 这 么 做 的 。 不 过 这 种 
做 法 只 适用 于 大 型 的 复杂 网 站 ， 或 者 对 现 有 网 站 做 了 重大 修改 。 对 我 们 这 个 简单 的 网 站 来 
说 ， 分 别 完 成 上 述 两 个 任务 更 合理 。 虽 然 最 终 这 两 个 任务 都 要 完全 自动 化 ， 但 就 目前 而 言 
或 许 更 适合 手动 配置 。 








在 阅读 过 程 中 ， 你 要 记 住 ， 配 置 的 过 程 各 异 ， 因 此 部 署 有 很 多 通用 的 最 佳 实践 。 所 以 ， 与 
其 尝试 记 住 我 的 具体 做 法 ， 不 如 试 着 理解 其 中 的 基本 原理 ， 这 样 以 后 你 遇 到 具体 问题 时 就 
能 使 用 相同 的 思想 解决 了 。 











8.4.1 选择 在 哪里 托管 网 站 
现今 ,托管 网 站 有 大 量 不 同 的 方案 ， 不 过 基本 上 可 以 归纳 为 两 类 : 





。 运行 自己 的 服务 器 (可 能 是 虚拟 服务 器 ) ， 
。 使 用 “平台 即 服 务 ”(Platform-As-A-Service，PaaS) 提供 商 ， 例 如 Heroku、DotCloud、 
OpenShift 或 PythonAnywhere。 

















对 小 型 网 站 而 言 ，Paas 的 优势 尤其 明显 ， 我 强烈 建议 你 考虑 使 用 PaaS。 不 过 ， 基 于 几 个 
原因 ， 本 书 不 会 使 用 PaaS。 首 先 ， 有 利益 冲突 ， 我 觉得 PythonAnywhere 是 最 棒 的 ， 但 我 
这 么 说 是 因为 我 在 这 家 公司 工作 。 甚 实 ， 各 家 Paas 提供 商 提供 的 支持 各 不 相同 ， 部 署 的 过 
程 也 不 一 样 ， 所 以 学 会 其 中 一 家 的 部 署 方法 并 不 能 在 别家 使 用 。 任 何 一 家 提供 商都 有 可 能 
完全 修改 部 署 过程 ， 或 者 当 你 阅读 这 本 书 时 已 经 停业 了 。 




















因此 ， 我 们 要 学 习 一 些 优秀 的 老式 服务 器 管理 方法 ， 包 括 SSH 和 Web 服务 器 配置 。 这 些 
方法 永远 不 会 过 时 ， 而 且 学 会 这 些 方法 还 能 从 头发 花白 的 老 前 辈 那 儿 得 到 一 些 尊重 。 





我 要 试 着 搭建 一 个 十 分 类 似 于 Paags 环境 的 服务 器 ， 不 管 以 后 你 选择 哪 种 配置 方案 ， 都 能 
用 到 这 个 部 署 过程 中 学 到 的 知识 。 





8.4.2 ”搭建 服务 器 

我 不 规定 你 该 怎么 搭建 服务 器 ， 不管 你 选择 使 用 Amazon AWS、Rackspace 或 Digital 
Ocean， 还 是 自己 的 数据 中 心里 的 服务 器 ， 抑 或 楼 梯 后 橱柜 里 的 Raspberry Pi 哪 种 方案 
都 行 ， 只 要 满足 以 下 条 件 即 可 : 








五 


。 服务 器 的 系统 使 用 Ubuntu (13.04 或 以 上 版 本 ) ; 
。 有 访问 服务 器 的 root 权限 ， 
。 外 网 可 访问 ， 

。 可 以 通过 SSH 登录 。 
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我 推荐 使 用 Ubuntu 发 行 版 是 因为 其 中 安装 了 Python 3.4， 而 且 有 一 些 配置 Nginx 的 特殊 方 
式 〈 后 文 会 用 到 ) 。 如 果 你 知道 自己 在 做 什么 ， 或 许可 以 换 用 其 他 发 行 版 ， 但 遇 到 问题 只 
能 靠 自 己 了 。 


有 些 人 阅读 本 章 时 会 跳 过 购买 域名 和 架设 真正 的 服务 器 这 两 部 分 ， 直 接 在 自 
己 的 电脑 中 使 用 虚拟 机 。 请 不 要 这 么 做 ， 这 两 种 方式 不 一 样 。 配 置 服务 器 本 
身 已 经 很 复杂 了 ， 如 果 用 虚拟 机 ， 阅 读本 章 的 内 容 时 会 遇 到 更 大 的 困难 。 如 
果 你 担心 要 花 钱 ， 可 以 四 处 找 找 ， 域 名 和 服务 器 都 有 免费 的 。 如 果 需 要 进 一 
步 指导 ， 可 以 给 我 发 电子 邮件 ， 我 一 直 都 乐于 助人 。 



































8.4.3 用 户 账 户 、SSH 和 权限 


本 节 假 定 你 的 用 户 账户 没有 root 权限 ， 但 有 使 用 sudo 的 权限 ， 因 此 执行 需要 root 权限 的 
操作 时 ， 我 们 可 以 使 用 sudo。 在 下 面 的 说 明 中 ， 如 果 需 要 用 sudo， 我 会 指出 来 。 如 果 需 要 
创建 非 root 用 户 ， 可 以 这 么 做 : 








# 这 些 命令 必须 以 root 用 户 的 身份 执行 

root@server:$ useradd -m -s /bin/bash elspeth # 添加 用 户 ,名 为 elspeth 
# -m 表 示 创 建 家 目录 ,-s 表 示 elspeth 默 认 能 使 用 bash 

root@server:$ usermod -a -G sudo elspeth # 把 elspeth 添 加 到 sudo 用 户 组 
root@server:$ passwd elspeth # 设置 elspeth 的 密码 

root@server:$ su - elspeth # 把 当前 用 户 切换 为 elspeth 
elspeth@server:$ 


























用 户 名 喜欢 用 什么 就 用 什么 。 通 过 SSH 登录 时 ， 我 建议 你 别 用 密码 ， 应 该 学 习 如 何 使 用 私 
钥 认 证 。 若 想 使 用 私 钥 认 证 ， 要 从 自己 的 电脑 中 获取 公 钥 ， 然 后 将 其 附加 到 服务 器 用 户 账户 
下 的 ~/.ssh/authorized_keys 文件 中 。 使 用 Bitbucket 或 GitHub 时 你 可 能 已 经 做 过 类 似 的 操作 。 





这 篇 文档 (https:Wlibrary.linode.comy/security/ssh-keys) 对 此 做 了 比较 详细 的 说 明 (注意 ,在 
Windows 中 ，ssh-keygen 包含 在 Git-Bash 中 )。 








注意 本 章 命 令 行 代码 清单 中 的 elspeth@server ， 它 表示 命令 必须 在 服务 器 中 
执行 ， 而 不 是 在 你 自己 的 电脑 中 执行 。 


8.4.4 安装 Nginx 


我 们 需要 一 个 Web 服务 器 ， 既 然 现 在 酷 小 孩 都 使 用 Nginx， 那 我 们 也 用 它 吧 。 我 和 Apache 
斗争 了 多 年 ， 可 以 说 单 就 配置 文件 的 可 读 性 这 一 项 而 言 ， Nginx 如 同 神 赐 般 拯救 了 我 们 。 




















在 我 的 服务 器 中 安装 Nginx 只 需 执 行 一 次 apt-get 命令 即 可 ， 然 后 再 执行 一 个 命令 就 能 看 
到 Nginx 默认 的 欢迎 页 面 : 











elspeth@server:$ sudo apt-get instaLL nginx 
elspeth@server:$ sudo service nginx start 


(你 可 能 要 先 执行 apt-get update 和 /或 apt-get upgrade。) 


现在 访问 服务 器 的 卫 地 址 就 能 看 到 Nginx 的 “Welcome to nginx”( 欢 迎 使 用 Nginx) 页 
面 ， 如 图 8-1 所 示 。 








-0 Welcome to nginx!- Mozilla Firefox 
| Welcome to nginx! [号 | 


ottg.eu ”©| 图 Goodle Qyvy 合 rn 


Welcome to nginx! 


If you see this page, the nginx web server is successfully installed and working. 
Further configuration is required. 


For online documentation and Support please refer to nginx.0rg. 
Commercial support is available at nginx.com. 


Thank you for using nginx. 


Dr S90 











图 8-1: Nginx 可 用 了 


如 果 没 看 到 这 个 页 面 ， 可 能 是 因为 防火 墙 没 有 开放 80 端口 。 以 AWS 为 例 ， 或 许 你 要 配置 
服务 器 的 “Security Group” 才 能 打开 80 端口 。 


既然 我 们 有 root 权限 ， 下 面 就 来 安装 所 需 的 系统 级 关键 软件 : Python、Git、pip 和 virtualenv。 




















elspeth@server:$ sudo apt-get instaLL git python3 python3-pip 
elspeth@server:$ sudo pip3 install virtualenv 


8.4.5 ”解析 过 渡 环 境 和 线 上 环境 所 用 的 域名 
不 想 总 是 使 用 人 地址， 所 以 要 把 过 渡 环 境 和 线 上 环境 所 用 的 域名 解析 到 服务 器 上。 我 的 注 
册 商 提供 的 控制 面板 如 图 8-2 所 示 。 
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DNS ENTRY TYPE PRIORITY TTL DESTINATIONITARGET 








A 81.21.76.62 Y|| 贸 
A 81.21.76.62 PAR; 
MX 10 mx0.123-reg.co.uk. p a: 
MX 20 mx1.123-reg.co.uk. | | 贸 
dev CNAME harry.pythonanywhere... Z| 留 
ww CNAME harry.pythonanywhere... | | 贸 
book-example A 82.196.1.70 | | 留 
book-example-staging A 82.196.1.70 | | 留 
A ay Add 





8-2: 解析 域名 


在 DNS 系统 中 ， 把 域名 指向 一 个 确切 的 人 P 地 址 叫 作 “A 记录 "。 各 注册 商 提供 的 界面 有 所 
不 同 ， 但 在 你 的 广 册 商 网 站 中 四 处 点 击 几 次 应 该 就 能 找到 正确 的 页 面 。 





8.4.6 ”使 用 功能 测试 确认 域名 可 用 而 且 Nginx 正 在 运行 
为 了 确认 一 切 顺利 ， 可 以 再 次 运行 功能 测试 。 你 会 发 现 失败 消息 稍微 有 点 儿 不 同 ， 其 中 一 
个 消息 和 Nginx 有 关 : 














$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 


[...] 


selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id new item"}' ; Stacktrace: 


[...] 


AssertionError: 'To-Do' not found in 'Welcome to nginx!' 


有 进展 。 


8.5 手动 部 署 代 码 


接着 要 让 过 渡 网 站 运行 起 来 ， 检 查 Nginx 和 Django 之 间 能 否 通信 。 从 这 一 步 起， 配置 结 
束 了 ， 进 入 “部 署 ” 阶 段 。 在 部 署 的 过 程 中 ， 要 思考 如 何 自 动 化 这 些 操作 。 





区 分 配置 阶段 和 部 署 阶段 有 个 经 验 法 则 : 配置 时 需要 root 权限 ， 但 部 署 时 不 





需要 一 个 文件 夹 用 来 存放 源码 。 假 设 源码 放 在 一 个 非 root 用 户 的 家 目录 中 ， 在 我 的 服务 器 
中 ， 路 径 是 /home/elspeth (好 像 所 有 共享 主机 的 系统 都 是 这 么 设置 的 。 不 论 使 用 什么 主机 ， 





一 定 要 以 非 root 用 户 身份 运行 Web 应 用 )。 我 要 按照 下 面 的 文件 结构 存放 网 站 的 代码 : 


/home/elspeth 

| 一 sites 

FF 一 www.live.my-website.com 
一 database 

-一 db.sqLite3 
一 source 

一 manage.py 
一 superLists 
H 一 etc... 


一 static 
上 一 base.css 
一 etc... 


— virtualenv 
| 一 Lib 
HF etc... 





FF- 一 www.staging.my-website.com 
一 database 


FE etc... 











每 个 网 站 (过渡 网 站 ， 线 上 网 站 或 其 他 网 站 ) 都 放 在 各 自 的 文件 夹 中 。 在 各 文件 夹 中 又 
有 单独 的 子 文件 夹 ， 分 别 存放 源码 、 数 据 库 和 静态 文件 。 采 用 这 种 结构 的 逻辑 依据 是 ， 
不 同 版 本 的 网 站 源码 可 能 会 变 ， 但 数据 库 始 终 不 变 。 静 态 文件 夹 也 在 同一 个 相对 位 置 ， 
即 ../static， 前 一 章 末 尾 我 们 已 经 设置 好 了 。 最 后 ，virtualenv 也 有 自己 的 子 文件 夹 。 你 











可 能 会 问 :“virtualenv 是 什么 ?” 稍 后 就 会 说 明 。 


8.5.1 调整 数据 库 的 位 置 


首先 ， 在 settings.py 中 修改 数据 库 的 位 置 ， 而 且 要 保证 修改 后 的 位 置 在 本 地 电脑 中 也 能 使 





用 。 使 用 0s .path.abspath 能 避免 以 后 混淆 当前 工作 目录 : 





superlists/settings.py (ch081003) 


# 项 目 内 的 路 径 使 用 os .path.join(BASE_DIR，...) 形 式 构建 


import os 


BASE_DIR = os.path.abspath(os.path.dirname(os.path.dirname(__ file ))) 


[ed 


DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.sqlite3', 


'NAME': os.path.join(BASE DIR, '../database/db.sqlite3'), 




















过 渡 网 站 测试 部 署 





使 用 


131 


Exead 


STATIC_ROOT = os.path.join(BASE_DIR, '../static') 


$ mkdir ../database 

$ python3 manage.py migrate --noinput 
Creating tables ... 

[5 过 

$ ls ../database/ 

db.sqlite3 


看 起 来 可 以 正常 使 用 。 做 次 提交 : 


$ git diff # 会 看 到 settings.py 中 的 改动 
$ git commit -am "move sqlite database outside of main source tree" 














= 




















你 该 怎么 推送 。 


背 助 代码 分 享 网 站 ， 使 用 Git 把 代码 上 传 到 服务 器 。 如 果 之 前 没 推送 ， 现 在 要 把 代码 推送 
到 GitHub、BitBucket 或 同类 网 站 中 。 这 些 网 站 都 为 初学 者 提供 了 很 好 的 用 法 说 明 ， 告 诉 


把 源码 上 传 到 服务 器 所 需 的 全 部 Bash 命令 如 下 所 示 。 如 果 你 不 熟悉 Bash 命令 ， 我 告诉 


你 ，export 的 作用 是 创建 一 个 可 在 bash 中 使 用 的 “本 地 变量 ”: 


elspeth@server:$ export SITENAME=superlists-staging.ottg.eu 
elspeth@server:$ mkdir -p ~/sites/$SITENAME/database 

elspeth@server:$ mkdir -p ~/sites/$SITENAME/static 

elspeth@server:$ mkdir -p ~/sites/$SITENAME/virtualenv 

# 要 把 下 面 这 行 命令 中 的 URL 换 成 你 自己 的 仓库 的 URL 

elspeth@server:$ git clone https://github.com/hjwp/book-example.git \ 
~/sites/$SITENAME/source 

Resolving deltas: 100% [...] 








使 用 export 定义 的 Bash 变量 只 在 当前 终端 会 话 中 有 效 。 如 果 退 出 服务 器 后 
再 登录 ， 就 需要 重新 定义 。 这 个 特性 有 点 隐 上 ， 因 为 Bash 不 会 报错 ， 而 是 
直接 用 空 字符 串 表 示 未 定义 的 变量 ， 这 种 处 理 方式 会 导致 诡异 的 结果 。 如 果 
不 信 ， 可 以 执行 echo $SITENAME 试 试 。 








现在 网 站 安装 好 了 ， 在 开发 服务 器 中 运行 试 试 一 一 这 是 一 个 冒 烟 测 试 ， 检 查 所 有 活动 部 件 


是 否 连接 起 来 了 : 


elspeth@server:$ $ cd ~/sites/$SITENAME/source 
$ python3 manage.py runserver 
Traceback (most recent call last): 
File "manage.py", line 8, in <module> 
from django.core.management import execute from command_line 
ImportError: No module named django.core.management 


啊 ， 服 务 器 上 还 没 安装 Django。 
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8.5.2 ”创建 虚拟 环境 

现在 就 可 以 安装 Django， 但 有 个 问题 : Django 发 布 新 版 后 ， 如 果 想 升级 ， 就 无 法 使 用 与 线 
上 网 站 不 同 的 版 本 测试 过 渡 网 站 。 而 且 ， 如 果 服 务 器 中 还 有 其 他 用 户 ， 所 有 人 都 只 能 使 用 
同一 个 Django 版 本 。 



































使 用 virtualenv 能 解决 这 种 问题 。virtualenv 使 用 一 种 优雅 的 方式 在 不 同 的 位 置 安 装 Python 
包 的 不 同 版 本 ， 把 不 同 的 版 本 放 在 各 自 的 “虚拟 环境 ”中 。 


先 在 本 地 电脑 中 试 一 下 : 


$ pip3 install virtualenv # 在 Linux/Mac 0S 中 需要 使 用 sudo 


沿用 为 服务 器 规划 的 文件 夹 结构 : 





$ virtualenv --python=python3 ../virtualenv 
$ Ls ../virtualenv/ 
bin include lib 


上 述 命令 会 新 建 一 个 文件 夹 ， 路 径 是 ../virtualenv。 在 这 个 文件 夹 中 有 自己 的 一 份 Python 
和 pip， 还 有 一 个 位 置 用 于 安装 Python 包 。 这 个 文件 夹 是 自 成 一 体 的 Python“ 虚拟 ” 环 
境 。 若 想 使 用 这 个 虚拟 环境 ， 可 以 执行 activate 脚本 ， 修 改 系统 路 径 和 Python 路 径 ， 让 
系统 使 用 这 个 虚拟 环境 中 的 可 执行 文件 和 包 : 


$ which python3 

/usr/bin/python3 

$ source ../virtualenv/bin/activate 

$ which python # 注意 ,切换 到 虚拟 环境 中 的 Python 了 
/workspace/virtualenv/bin/python 

(virtualenv)$ python3 manage.py test lists 

[ss] 


ImportError: No module named 'django' 





或 许 你 想 使 用 virtualenvwrapper 管理 电脑 中 的 虚拟 环境 。 但 这 个 工具 不 是 
必须 的 。 








在 Windows 中 使 用 virtualenv 
在 Windows 中 有 细微 的 差别 ， 使 用 时 要 注意 两 件 事 : 
。 virtualenv/bin 文件 夹 叫 virtualenv/Scripts ， 因 此 要 视 情 况 替 换 ; 


。 在 Git-Bash 中 不 要 试图 运行 activate.bat， 这 个 文件 是 为 DOS shell 编写 的 ， 要 执行 


source ..\virtualenv\Scripts\activate。source 是 关键 。 
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我 们 看 到 了 错误 消息 “ImportError: No module named django”， 这 是 因为 还 没 在 虚拟 环境 中 
安装 Django。 下 面 安装 Django。 你 会 看 到 ，Django 被 安装 到 虚拟 环境 的 site-packages 文 
件 夹 中 : 


(virtualenv)$ pip install django==1.7 

| We 

Successfully instaLLed django 

Cleaning up... 

(virtualenv)$ python3 manage.py test lists 


[i] 


OK 

$ ls ../virtualenv/lib/python3.4/site-packages/ 

django pip setuptools 
Django-1.7-py3.4.egg-info pip-1.4.1-py3.4.egg-info setuptools-0.9.8-py3.4.egg-info 
easy_install.py pkg_resources.py 

_markerLib __pycache_ 


为 了 保存 虚拟 环境 中 所 需 的 包 列 表 ， 也 为 了 以 后 能 再 次 创建 相同 的 虚拟 环境 ， 可 以 执行 
pip freeze 命令 ， 1 个 requirements.txt 文件 ， 再 把 这 个 文件 添加 到 仓库 中 : 




















(virtualenv)$ pip freeze > requirements.txt 
(virtualenv)$ deactivate 

$ cat requirements.txt 

Django==1.7 

$ git add requirements.txt 

$ git commit -m"Add requirements.txt for virtualenv" 


Django 1.7 还 没 发 布 ， 可 以 使 用 pip instaLL https://github.com/django/ 
django/archive/stable/1.7.x.zip 安装 这 个 版 本 。 在 requirements.txt 中 可 以 
把 “Django==1.7” 换 成 这 个 URL，pip 很 智能 ， 能 解析 URL。 可 以 在 本 地 
执行 pip install -r requirements.txt 命令 ,测试 复 建 虚拟 环境 。 会 看 到 
pip 提示 ， 所 有 包 都 已 安装 。 








现在 执行 qit push 命令 ， 把 更 新 推送 到 代码 分 享 网 站 中 : 


$ git push 








然后 ， 在 服务 器 上 拉 取 这 些 更 新 ， 创 建 一 个 虚拟 环境 ， 再 执行 pip install -r requirements.txt 
命令 ,让 服务 器 中 的 虚拟 环境 和 本 地 一 样 : 














elspeth@server:$ git puLL # 可 能 会 要 求 你 先 做 git config 
elspeth@server:$ virtualenv --python=python3 ../virtualenv/ 
elspeth@server:$ ../virtualenv/bin/pip install -r requirements.txt 
Downloading/unpacking Django==1.7 (from -r requirements.txt (line 1)) 
[is] 

Successfully installed Django 

Cleaning up... 

elspeth@server:$ ../virtualenv/bin/python3 manage.py runserver 





Validating models... 
0 errors found 


[...] 
看 起 来 服务 器 运行 得 很 顺畅 ， 按 Ctrl-C 键 暂时 关闭 服务 器 。 


注意 ， 使 用 虚拟 环境 并 不 一 定 要 执行 activate， 直 接 指定 虚拟 环境 中 的 python 或 pip 的 路 
径 也 行 。 在 服务 器 上 ， 我 们 就 直接 使 用 路 径 。 








大 多 数 人 喜欢 在 项 目 伊始 就 创建 虚拟 环境 。 等 到 现在 才 创 建 ， 是 因为 我 想 让 


前 几 章 尽量 简单 一 些 。 





























8.5.3 简单 配置 Nginx 


下 面 创建 一 个 Nginx 配置 文件 ， 把 过 渡 网 站 收 到 的 请 求 交 给 Django 处 理 。 如 下 是 一 个 极 
简 的 配置 。 


























Server: /etc/nginx/sites-available/superlists-staging.ottg.eu 
server { 
listen 80; 
server_name superlists-staging.ottg.eu; 


location / { 
proxy_pass http://LocaLhost:8000 
} 
} 











这 个 配置 只 对 过 渡 网 站 的 域名 有 效 ， 而 且 会 把 所 有 请 求 “代理 ”到 本 地 8000 端口 ， 等 待 
Django 处 理 请 求 后 得 到 的 响应 。 





我 把 这 个 配置 保存 “为 superlists-staging.ottg.eu 文件 ， 放 在 /etc/nginx/sites-available 文件 来 
里 ， 然 后 创建 一 个 符号 链接 ， 把 这 个 文件 加 入 局 用 的 网 站 列表 中 : 





elspeth@server:$ echo $SITENAME # 检查 在 这 个 shell 会 话 中 是 否 还 能 使 用 这 个 变量 获取 网 站 名 
superlists-staging.ottg.eu 

elspeth@server:$ sudo ln -s ../sites-available/$SITENAME \ 
/etc/nginx/sites-enabled/$SITENAME 

elspeth@server:$ ls -1 /etc/nginx/sites-enabled # 确认 符号 链接 是 否 在 那里 








在 Debian 和 Ubuntu 中 ， 这 是 保存 Nginx 配置 的 推荐 做 法 一 一 把 真正 的 配置 文件 放 在 sites- 




















注 2: 不 知道 在 服务 器 中 如 何 编辑 文件 吗 ? 服务 器 中 都 有 vi， 我 始终 鼓励 你 学 习 如 何 使 用 这 个 工具 。 或 者 可 以 
用 对 初学 者 相对 友好 的 nano。 注 意 ， 你 还 得 使 用 sudo， 因 为 这 个 文件 在 系统 文件 夹 中 。 








全 
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available 文件 夹 中 ， 然 后 在 sites-enabled 文件 夹 中 创建 一 个 符号 链接 。 这 么 做 便于 切换 网 
站 的 在 线 状态 。 








或 许 我 们 还 可 以 把 默认 的 “Welcome to nginx” 页 面 删除 ， 避 免 混 请 











elspeth@server:$ sudo rm /etc/nginx/sites-enabled/default 
现在 测试 一 下 配置 : 


elspeth@server:$ sudo service nginx reload 
elspeth@server:$ ../virtualenv/bin/python3 manage.py runserver 


我 还 要 编辑 /etc/nginx/nginx.conf 文件 ， 把 server_names_hash_bucket_size 


64; 这 行 的 注释 去 掉 ， 这 样 才能 使 用 我 的 长 域名 。 你 或 许 不 会 遇 到 这 个 问题 。 
执行 reload 命令 时 ， 如 果 配 置 文件 有 问题 ，Nginx 2 


快速 进行 视觉 确认 一 一 网 站 运行 起 来 了 (如 图 8-3) ! 














To-Do lists - Mozilla Firefox (Private Browsing) x 
File Edit View History Bookmarks Tools Help 
9 | {To-Dolists [ 叱 | 
《 [ superlists-staging.ottg.eu v P| 图 coo QAyvy 合 Ee 
[o-Do list 
E t e 
@- 其 S 











图 8-3: 过 渡 网 站 运行 起 来 了 ! 
我 们 来 看 功能 测试 的 结果 如 何 : 


$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
[si 

selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
[xs] 

AssertionError: 0.0 != 512 within 3 delta 
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尝试 提交 新 待 办 事项 时 测试 失败 了 ， 因 为 还 没 设置 数据 库 。 运 行 测试 时 你 可 





注意 到 了 


Django 的 黄色 报错 页 (如 图 8-4 所 示 ， 手 动 访 问 网 站 也 能 看 到 )， 南面 中 显示 的 信息 和 测 


试 失败 消息 差不多 。 








试 能 。 


测试 让 们 避免 陷入 可 能 出 现 的 窘境 之 中 。 访 问 网 站 首页 时 看 起 来 很 正常 ， 
果 此 时 草率 地 认为 工作 结束 了 ， 那 个 扰 人 的 Django 报错 页 就 会 被 网 站 的 首 
批 用 户 发 现 。 好 吧 ， 这 人 么 说 可 能 夸大 了 影响 ， 说 不 定 我 们 自己 已 经 发 现 了 ， 
可 是 如 果 网 站 越 来 越 大 、 越 来 越 复 杂 怎 么 办 ? 你 不 可 能 确认 每 项 功能 ， 但 测 


如 





-oo DatabaseErrorat /lists/new - Mozilla Firefox 
|E } DatabaseError at /lists/new [| 字 | 


DatabaseError at /lists/new 


no such table: lists list 


Request Method: POST 
Request URL: http://localhost:8000/lists/Nnew 
Django Version: 1.5.1 
Exception Type: DatabaseError 
Exception Value: "no such table: lists list 
Exception Location: /home/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/site-packages/django 
/db/backends/sqlite3/base.py in execute, line 362 
Python Executable: /home/harry/sites/superlists-staging.ottg.eu/virtualenv/bin/python3 
Python Version: 3.3.1 
=: [【'/home/harry/sites/superlists-staging.ottg.eu/source’, 

Python Path: "/home/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3", 
"/home/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/plat-x86 64-linux-gnu", 
"/home/harry/sites/supertists-staging.ottg.eu/virtuatenv/tib/python3.3/tib-dyntoad'， 
"/usr/Lib/python3.3", 

"/usr/Lib/python3.3/pLat-x86 64-Linux-gnu'， 
"/home/harry/sites/supertists-staging.ottg.eu/virtuatenv/tib/python3.3/site-packages'"] 


Server time: Mon, 5 Aug 2013 10:49:12 -0500 


Traceback switch to copy-and-paste view 





/home/harry/sites/supertists-staging.ottg.eu/virtuatenv/tib/python3.3/site-packages/django/core/handters/base.py iN get_response 
115. response = catlback{request, *callback args, **callback kwargs) 


bP Local vars 





€ |@ superlists-staging.ottg.ey ne ”© 图 cooole Ql 合 be 


的 


























@O- % 
图 8-4: 数据 库 还 无 法 使 用 
8.5.4 使 用 迁移 创建 数据 库 
执行 migrate 命令 时 ， 可 以 指定 - -noinput 参数 ， 禁 止 两 次 询问 “你 确定 吗 ”: 

elspeth@server:$ ../virtualenv/bin/python3 manage.py migrate --noinput 

Creating tables ... 

Ess] 

elspeth@server:$ Ls ../database/ 

db.sqLite3 

elspeth@server:$ ../virtualenv/bin/python3 manage.py runserver 
再 运行 功能 测试 试 试 : 
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$ python3 manage.py test functional_tests --Liveserver=superLists-staging.ottg.eu 
Creating test database for alias 'default'... 


Ran 2 tests in 10.718s 


OK 
Destroying test database for alias 'default'... 


看 到 网 站 运行 起 来 的 感觉 太 棒 了 ! 继续 阅读 下 一 市 之 前 ， 或 许 我 们 可 以 入 党 自己， 喝 杯 茶 
休息 一 下 一 一 这 是 你 应 得 的 奖励 。 











如 果 看 到 “502 - Bad Gateway” 错 误 ， 可 能 是 因为 执行 migrate 命令 之 后 扎 
记 使 用 manage.py runserver 重启 开发 服务 器 。 











8.6 为 部 署 到 生产 环境 做 好 准备 


至 少 我 们 已 经 确认 基本 的 pip 操作 能 正常 使 用 了 ,但 是 在 生产 环境 中 真 的 不 能 使 用 Django 
开发 服务 器 。 而 且 ， 不 能 依靠 runserver 手动 启动 服务 器 。 


8.6.1 换 用 Gunicorn 

知道 为 什么 Django 的 吉祥 物 是 一 匹 小 马 吗 ? Django 提供 了 很 多 功能 ， 包 括 ORM、 各 种 
中 间 件 、 网 站 后 台 等 。“ 除 了 小 马 之 外 你 还 想 要 什么 呢 ?” 我 想 ， 既 然 你 已 经 有 一 匹 小 马 
了 ， 或 许 你 还 想 要 一 头 “绿色 独 角 兽 ”(Green Unicorn) ， 即 Gunicorn。 








elspeth@server:$ ../virtualenv/bin/pip install gunicorn 


Gunicorn 需要 知道 WSGI (Web Server Gateway Interface，Web 服务 器 网 关 接口 ) 服务 器 的 
路 径 。 这 个 路 径 往往 可 以 使 用 一 个 名 为 application 的 函数 获取 。Django 在 文件 superlists/ 
wsgi.py 中 提供 了 这 个 函数 : 

















elspeth@server:$ ../virtualenv/bin/gunicorn superlists.wsgi:application 
2013-05-27 16:22:01 [10592] [INFO] Starting gunicorn 0.18.0 

2013-05-27 16:22:01 [10592] [INFO] Listening at: http://127.0.0.1:8000 (10592) 
[aial 


如 有 果 现 在 访问 网 站 ， 会 发 现 所 有 样式 都 失效 了 ， 如 图 8-5 所 示 。 


如 果 运 行 功能 测试 ， 会 看 到 的 确 出 问题 了。 添加 待 办 事项 的 测试 能 顺利 通过 ， 但 布局 和 样 
式 的 测试 失败 了 。 视 试 做 得 不 错 ! 
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$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
[...] 

AssertionError: 125.0 != 512 within 3 delta 

FAILED (failures=1) 





样式 失效 的 原因 是 ，Django 开发 服务 器 会 自动 伺服 静态 文件 ， 但 Gunicorn 不 会 。 现 在 配 
置 Nginx， 让 它 代为 伺服 静态 文件 。 





Ba 

















[ -oo To-Do lists- Mozilla Firefox ] 
|MYourne... |S Digitalo... | WName-b.…. | 俐 Quickco...| i ToD... % |Qhjwp/bo.….| 团 Howto... | 穴 GNuso.… | 呈 | 
《 2 obeythetestinggoat.com -@| 图 - heconfigfileswQ 内 合 1- 


Start a To-Do list 


@ Scripts Partially Allowed, 1/2 (obeythetestinggoat.com) | <SCRIPT>: 2| <OBJECT>: 0 
加 ”其 号 曲 














8-5: 样式 失效 


8.6.2 ”让 Nginx 伺 服 静态 文件 


首先 ， 执 行 coLLectstattic 命令 ， 把 所 有 静态 文件 复制 到 一 个 Nginx 能 找到 的 文件 来 中 : 


elspeth@server:$ ../virtualenv/bin/python3 manage.py collectstatic --noinput 
elspeth@server:$ 1s ../static/ 
base.css bootstrap 


再 次 注意 ， 除 了 使 用 虚拟 环境 的 activate 命令 之 外 ， 还 可 以 直接 使 用 虚拟 环境 中 的 Python 
副本 路 径 。 





下 面 配置 Nginx， 让 它 伺 服 静 态 文件 。 
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Server: /etc/nginx/sites-available/superlists-staging.ottg.eu 


server { 
listen 80; 
server_name superlists-staging.ottg.eu; 


location /static { 
alias /home/elspeth/sites/superlists-staging.ottg.eu/static; 


} 


location / { 
proxy_pass http://LocaLhost:8000; 
} 
} 


然后 重启 Nginx 和 Gunicorn: 





elspeth@server:$ sudo service nginx reload 
elspeth@server:$ ../virtualenv/bin/gunicorn superlists.wsgi:application 





如 果 再 次 访问 网 站 ， 会 看 到 外 观 正常 多 了 。 可 以 再 次 运行 功能 测试 确认 : 


$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
Creating test database for alias 'default'... 


Ran 2 tests in 10.718s 


OK 
Destroying test database for alias 'default'... 


8.6.3” 换 用 Unix 套 接 字 

如 果 想 要 同时 伺服 过 渡 网 站 和 线 上 网 站 ， 这 两 个 网 站 就 不 能 共用 8000 端口 。 可 以 为 不 同 
网 站 分 配 不 同 端口 ， 但 这 么 做 有 点 儿 随 意 ， 而 且 很 容易 出 错 ， 万 一 在 线 上 网 站 的 端口 上 启 
动 过 渡 服 务 器 (或 者 反 过 来 ) 怎么 办 。 


更 好 的 方法 是 使 用 Unix 域 套 接 字 。 域 套 接 字 类 似 于 硬盘 中 的 文件 ， 不 过 还 可 以 用 来 处 理 
Nginx 和 Gunicorn 之 间 的 通信 。 要 把 套 接 字 保存 在 文件 夹 /tmp 中 。 下 面 修改 Nginx 的 代理 
设置 。 

















Server: /etc/nginx/sites-available/superlists-staging.ottg.eu 


[i 
location / { 
proxy_set_header Host $host; 
proxy_pass http://unix:/tmp/superlists-staging.ottg.euy.socket; 


} 





proxy_set_header 的 作用 是 让 Gunicorn 和 Django 知道 它们 运行 在 哪个 域名 下 。ALLOWED_HOSTS 
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安全 功能 需要 这 个 设置 ， 稍 后 会 启用 这 个 功能 。 








现在 重启 Gunicorn， 不 过 这 一 次 告诉 它 监 听 套 接 字 ， 而 不 是 默认 的 端口 : 


elspeth@server:$ sudo service nginx reload 
elspeth@server:$ ../virtualenv/bin/gunicorn --bind \ 
unix:/tmp/superlists-staging.ottg.eu.socket superlists.wsgi:application 








还 要 再 次 运行 功能 测试 ， 确 保 所 有 测试 仍 能 通过 : 











$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
OK 


8.6.4 ”把 DEBUG 设 为 False， 设 置 ALLOWED_HOSTS 


自己 的 服务 器 中 开启 调试 模式 有 利于 排查 问题 ， 但 显示 满 页 的 调用 跟踪 不 安全 (https:/ 
docs.djangoproject.com/en/1.7/ref/settings/#debug ) 。 


[ey 








在 settings.py 的 顶部 有 DEBUG 设置 项 。 如 果 把 它 设 为 False， 还 需要 设置 男 一 个 选项 ，ALLOWED_ 
HOSTS。 这 个 设置 在 Django 1.5 中 添加 ， 目 的 是 提高 安全 性 (https://docs.djangoproject.com/en/1.7/ 
ref/settings/#std:setting-ALLOWED_HOSTS)。 不 过 ， 在 默认 的 settings.py 中 没有 为 这 个 功能 提 
供 有 帮助 的 注释 。 那 就 自己 添加 这 个 选项 吧 ， 在 服务 器 中 按照 下 面 的 方式 修改 settings.py。 





SeE1Ve1 superlists/settings.py 


# 安全 警告 : 别 在 生产 环境 中 开启 调试 模式 | 
DEBUG = False 





TEMPLATE_DEBUG = DEBUG 
# DEBUG=False 时 需要 这 项 设置 


ALLOWED_HOSTS = ['superlists-staging.ottg.eu'] 
ee 


然后 重启 Gunicorn， 再 运行 功能 测试 ， 确 保 一 切 正常 。 





在 服务 器 中 别提 交 这 些 改动 。 现 在 这 只 是 为 了 让 网 站 正常 运行 做 的 小 调整 ， 不 是 
需要 纳入 仓库 的 改动 。 一 般 来 说 ， 简 单 起 见 ， 我 只 会 在 本 地 电脑 中 把 改动 提交 到 
Git 仓库 中 。 如 果 需 要 把 代码 同步 到 服务 器 中 ， 再 使 用 git push 和 git pull。 


























8.6.5 ”使 用 Upstart 确 保 引 导 时 启动 Gunicorn 


部 署 的 最 后 一 步 是 确保 服务 器 引导 时 自动 启动 Gunicorn， 如 果 Gunicorn 崩溃 了 还 要 自动 重 
局。 在 Ubuntu 中 ， 可 以 使 用 Upstart 实现 这 个 功能 。 
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server: /etc/init/eunicorn-superlists-staging.otte.eu.conf 


description "Gunicorn server for superlists-staging.ottg.eu" 


start on net-device-up @ 
stop on shutdown 


respawn © 


setuid elspeth © 
chdir /home/elspeth/sites/superlists-staging.ottg.eu/source @ 


exec ../virtualenv/bin/gunicorn \ © 


--bind unix:/tmp/superlists-staging.ottg.eu.socket \ 
superlists.wsgi:application 


Upstart 的 配置 很 简单 (如果 曾经 编写 过 init.d 脚本 ,会 觉得 更 简单 )， 而 且 一 目 了 然 。 











@ start on net-device-up 确保 只 在 服务 器 联网 时 才 启 动 Gunicorn。 


@ 如 果 进 程 月 涡 ，respawn 会 自动 重启 Gunicorn。 











@ setuid 确保 以 elspeth 用 户 的 身份 运行 Gunicorn 进程 。 


@ chdir 设 定 工作 目录 。 


tt 


@ exec 是 真正 要 执行 的 进程 。 








Upstart 脚本 保存 在 /etc/init 中 ， 而 且 文 件 名 必须 以 .conf 结尾 。 
现在 可 以 使 用 start 命令 启动 Gunicorn 了 : 
elspeth@server:$ sudo start gunicorn-superlists-staging.ottg.eu 


然后 可 以 再 次 运行 功能 测试 ， 确 保 一 切 仍 能 正常 运行 。 你 甚至 还 可 以 重启 服务 器 ， 查 看 网 
是 


站 否 能 够 恢复 运行 。 


8.6.6 ”保存 改动 : 把 Gunicom 添 加 到 requirements.txt 
回 到 本 地 仓库 ， 应 该 把 Gunicom 添加 到 虚拟 环境 所 需 的 包 列 表 中 : 


$ source ../virtualenv/bin/activate # 如 有 必要 
(virtualenv)$ pip install gunicorn 

(virtualenv)$ pip freeze > requirements.txt 

(virtualenv)$ deactivate 

$ git commit -am "Add gunicorn to virtualenv requirements" 
$ git push 











8.7 上 自动 化 


总 结 一 下 配置 和 部 署 的 过 程 。 


。 配置 





(1) 假设 有 用 户 账户 和 家 目录 ; 
(2) apt-get nginx git python-pip; 


(3) pip instaLL virtuatLenv 
(4) 添加 Nginx 虚拟 主机 配置 ; 


(5) 添加 Upstart 任务 ， 


自动 启动 Gunicorn。 





(1) 在 ~/sites 中 创建 目录 结构 ， 
(2) 拉 取 源码 ， 保 存 到 source 文件 夹 中 ， 
(3) 启用 ../virtualenv 中 的 虚拟 环境 ; 


(4) pip install -r requtrements .txt; 


(5) 执行 manage.py migrate， 创 建 数据 库 ， 
(6) 执行 coLLectstatic 命令 ， 收 集 静 态 文件 ; 











写作 本 书 时 ， 在 Windows 中 使 用 pip 能 顺利 安装 Gunicorn， 但 Gunicorn 无 法 
正常 使 用 。 幸 好 我 们 只 在 服务 器 中 使 用 Gunicorn， 因 此 这 不 是 问题 。 不 过 ， 
对 Windows 的 支持 正在 讨论 中 (http://stackoverflow.com/questions/11087682/ 


does-gunicorn-run-on-windows ) 。 


(7) 在 settings.py 中 设置 DEBUG = False 和 ALLOWED_HOSTS; 


(8) 重启 Gunicorn; 


(9) 运行 功能 测试 ， 确 保 一 切 正常 。 


假设 现在 不 用 完全 自动 化 配置 过 程 ， 应 该 怎 
保存 起 来 ， 便 于 以 后 重用 。 下 夯 


Nginx 和 Upstart 配置 文 但 
一 个 新 建 的 子 文件 夹 中 





么 保存 现 


阶段 取得 的 结果 呢 ? 我 说 应 该 把 











i 把 这 两 个 配置 文件 保存 到 仓库 中 








$ mkdir deploy_tools 


server { 
listen 80; 


Server_name SITENAME; 


location /static { 
alias /home/elspeth/sites/SITENAME/static; 


} 


deploy tools/nginx.template.conf 
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location / { 
proxy_set_header Host $host; 
proxy_pass http://unix:/tmp/SITENAME.socket; 


deploy_tools/gunicorn-upstart.template.conf 


description "Gunicorn server for SITENAME" 


start on net-device-up 
stop on shutdown 


respawn 


setuid elspeth 
chdir /home/elspeth/sites/SITENAME/source 


exec ../virtualenv/bin/gunicorn \ 


--bind unix:/tmp/SITENAME.socket \ 
superlists.wsgi:application 


以 后 使 用 这 两 个 文件 配置 新 网 站 就 容易 了 ， 查 找 替换 SITENAME 即 可 。 
其 他 步骤 做 些 笔记 就 行 。 为 什么 不 在 仓库 中 建 个 文件 保存 说 明 呢 ? 





deploy_tools/provisionineg notes.md 
配置 新 网 站 


状 需要 安装 的 包 ， 


nginx 
Python 3 
Git 

pip 
virtualenv 


XX XX XX A 交 





以 ubuntu 为 例 ,可 以 执行 下 面 的 命令 安装 ; 














sudo apt-get install nginx git python3 python3-pip 
sudo pip3 install virtualenv 


## 配置 Nginx 虚 拟 主 机 


* 参考 nginx.template.conf 
* 把 SITENAME 标 换 成 所 需 的 域名 ,例如 stagtng.my-domain.com 


## Upstart 任 务 


* 参考 gunicorn-upstart.template.conf 
* 把 SITENAME 杰 换 成 所 需 的 域名 ,例如 staging.my-domain.com 
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## 文件 夹 结 构 : 


假设 有 


/home/ 
[一 S 


用 户 账户 ,家 目录 为 /home/username 


username 
ites 


上 -一 SITENAME 


| 一 database 


| 一 source 
| 一 static 


[一 virtuaLenv 


然后 提交 上 述 改动 : 


$ git 
$ git 


add deploy_tools 
status # 看 到 三 个 新 文件 





$ git commit -m "Notes and template config files for provisioning" 


现在 ,源码 的 目录 结构 如 下 所 示 : 


$ tree 


人 


Of 


| 


-I __pycache __ 


eploy_tools 
— gunicorn-upstart.template.conf 
— nginx.template.conf 
— provisioning notes.md 
unctional_tests 
-一 _init_ .py 
CC— [...] 
ists 
FF 一 init .py 
FF- 一 modeLs.py 
六 一 static 
| 一 base.css 
上 上] 


— tempLates 
| 一 base.htmL 





上 一 m 
Fr 


2 





= [3;] 
anage.py 
equirements.txt 
uperlists 


= 
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测试 驱动 服务 器 配置 和 部 署 

。 测试 去 除了 部 署 过 程 中 的 菜 些 不 确定 性 
对 开发 者 而 言 ， 服 务 器 管理 总 是 很 “有 趣 "。 我 说 的 “有 趣 ”是 指 ， 这 个 过 程 充满 
了 不 确定 性 和 惊喜 。 本 章 的 目的 是 告诉 你 ， 功 能 测试 组 件 能 去 除 这 个 过 程 中 的 某 
些 不 确定 性 。 

。 常见 痛 点 ， 数据 库 、 静 态 文件 、 依 赖 和 自 定义 设置 
每 次 部 署 时 都 要 小 心 处 理 数据 库 配 置 、 静 态 文件 和 软件 依赖 ， 还 要 修改 开发 环境 和 
生产 环境 之 间 有 差异 的 设置 。 每 次 部 署 时 都 要 认真 思考 怎么 处 理 这 几 件 事 。 

。 测试 允许 我 们 做 实验 
只 要 修改 了 服务 器 配置 ， 就 可 以 运行 测试 组 件 ， 确 认 一 切 是 否 仍 能 正常 运行 。 有 了 
测试 ， 就 能 大 胆 实验 ，。 








“保存 进展 ” 

在 过 渡 服 务 器 中 运行 功能 测试 ， 能 让 我 们 相信 网 站 确实 能 正常 运行 。 但 大 多 数 情况 下 ， 你 
并 不 想 在 真正 的 服务 器 中 运行 功能 测试 。 为 了 不 让 我 们 的 劳动 付 之 东 流 ， 并 且 保 证 生产 服 
务 器 和 过 渡 服 务 器 一 样 能 正常 运行 ， 要 让 部 署 的 过 程 可 重复 执行 。 











为 此 ， 我 们 需要 自动 化 。 这 是 下 一 章 的 话题 。 
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使 用 Fabric 自 动 部 署 





“自动 化 ， 自 动 化 ， 自 动 化 。” 


Cay Horstman 

















手动 部 团 过 渡 服 务 器 的 意义 通过 自动 部 署 才能 体现 出 来 。 部 署 的 过 程 能 重复 执行 ， 我们 才 
能 确信 部 署 到 生产 环境 时 不 会 出 错 。 
使 用 Fabric 可 以 在 服务 器 中 自动 执行 命令 。 可 以 系统 全 局 安装 Fabric， 因 为 它 不 是 网 站 的 


核心 功能 ， 所 以 不 用 放 到 虚拟 环境 中 ， 也 不 用 加 入 requirements.txt 文件 。 在 本 地 电脑 中 执 
行 下 述 命 令 安 装 Fabric: 





$ pip2 install fabric 





写作 本 书 时 ，Fabric 还 不 兼容 Python 3， 因 此 要 使 用 针对 Python 2 的 版 本 。 
幸好 使 用 Fabric 编写 的 代码 和 网 站 的 代码 完全 隔离 ， 所 以 这 不 是 问题 。 











在 Windows 中 安装 Fabric 


Fabric 依赖 于 pycrypto， 而 这 个 包 需 要 编译 。 在 Windows 中 编译 相当 痛苦 ， 所 以 使 
用 好 心 人 预先 编译 好 的 二 进 制 安装 程序 往往 更 快捷 。Michael Foord! 提供 了 一 些 预 




















注 1: Mock 库 的 作者 ，unittest 的 维护 者 。 如 果 Python 测试 领域 需要 一 名 摇滚 明星 ， 非 他 莫 属 。 
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先 编译 好 的 pycrypto Windows 二 进 制 安装 程序 (http://www.voidspace.org.uk/python/ 
modules.shtml#pycrypto) 。 


在 Windows 中 安装 Fabric 的 过 程 如 下 : 
(1) 从 前 面 提供 的 地 址 下 载 并 安装 pycrypto; 
(2) 使 用 pip 安装 Fabric。 


还 有 一 个 预 编译 好 的 Python 包 Windows 安装 程序 源 (http://www.lfd.uci.edu/~gohlke/ 
pythonlibs/) 也 很 棒 ， 由 Christoph Gohlke 维护 。 














Fabric 的 使 用 方法 一 般 是 创建 一 个 名 为 fabfile.py 的 文件 ， 在 这 个 文件 中 定义 一 个 或 多 个 函 
数 ， 然 后 使 用 命令 行 工具 fab 调用 ， 就 像 这 样 : 





fab function_name,host=SERVER_ADDRESS 


这 个 命令 会 调用 名 为 function_name 的 函数 ， 并 传人 要 连接 的 服务 器 地 址 SERVER_ADDRESS 。 
fab 命令 还 有 很 多 其 他 参数 ， 可 以 指定 用 户 名 和 密码 等 ， 详 情 可 执行 fab --help 命令 查阅 。 


9.1 分 析 一 个 Fabric 部 署 脚本 


Fabric 的 用 法 最 好 通过 一 个 实例 讲解 。 我 事先 写 好 了 一 个 脚本 *， 自 动 执行 前 一 章 用 到 的 所 
有 部 署 步骤 。 在 这 个 脚本 中 ， 主 国 数 是 main， 我 们 在 命令 行 中 要 调用 的 就 是 这 个 函数 。 除 
此 之 外 ， 脚 本 中 还 有 多 个 辅助 函数 。 从 命令 行 中 传 入 的 服务 器 地 址 保存 在 env.host 中 。 























deploy tools/fabfile.py 


from fabric.contrib.files import append, exists, sed 
from fabric.api import env, local, run 
import random 


REPO_URL = 'https://github.com/hjwp/book-example.git' #@ 


def deploy(): 
site folder = '/home/%s/sites/%s' % (env.user, env.host) #@@ 
source folder = site folder + '/source' 
_create directory_structure if necessary(site folder) 
_get_ latest_ source(source_folder) 
_update_settings(source_folder, env.host) 
_update_virtualenv(source_folder) 
_update static files(source folder) 
_update_database(source_folder) 














注 2: BBC 的 儿童 节目 《 蓝 彼 得 》 中 经 常 说 这 句 话 ， 因 为 这 是 个 直播 节目 ,为 了 节省 时 间 ， 往往 要 事先 做 好 所 
需 的 道具 。 参 见 http://www.bbc.co.uk/cult/classic/bluepeter/valpetejohn/trivia.shtml。 这 句 话 的 原文 是 “Here’s 


oneImade earlier”。 一 一 译 者 注 
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@ 要 把 常量 REPO_URL 的 值 改 成 代码 分 享 网 站 中 你 仓库 的 URL。 





@ env.host 的 值 是 在 命令 行 中 指定 的 服务 器 地 址 ， 例 如 superlists.ottg.eu。 








@ env.user 的 值 是 登录 服务 器 时 使 用 的 用 户 名 。 








希望 辅助 函数 的 名 字 能 表明 各 自 的 作用 。 理 论 上 fabfile.py 中 的 每 个 函数 都 能 在 命令 行 中 
调用 ， 所 以 我 使 用 了 一 种 约定 ， 几 是 以 下 划 线 开头 的 函数 都 不 是 fabfile.py 的 “公开 APT 。 
这 些 辅 助 函 数 按照 执行 的 顺序 排列 。 


创建 目录 结构 的 方法 如 下 ， 即 便 某 个 文件 夹 已 经 存在 也 不 会 报错 : 


























deploy_ tools/fabfile.py 


def create directory_structure if necessary(site folder): 
for subfolder in ('database', 'static', 'virtualenv', 'source'): 
run('mkdir -p %s/%s' % (site_folder, subfolder)) #0@ 


@ run 是 最 常用 的 Fabric 函数 ， 作 用 是 在 服务 器 中 执行 指定 的 shell 命令 。 








@ mkdir -p 是 mkdir 的 一 个 有 用 变种 ， 它 有 两 个 优势 : 其 一 ， 深 入 多 个 文件 夹层 级 创建 目 
录 ; 其 二 ， 只 在 必要 时 创建 目录 。 所 以 ，mkdir -p /tmp/foo/bar 除了 创建 目录 bar 之 
外 ， 如 果 需 要 ， 还 会 创建 父 级 目录 foo。 而 且 ， 如 果 目 录 bar 已 经 存在 ， 也 不 会 报错 。 

















然后 拉 取 源码 : 


deploy_ tools/fabfile.py 


def get latest source(source folder): 
if exists(source folder + '/.git'): #0 
run('cd %s && git fetch' % (source folder,)) #@@ 
else: 
run('git clone %s %s' % (REPO_URL, source_folder)) #@ 
current_commit = local("git log -n 1 --format=%H", capture=True) #@ 
run('cd %s && git reset --hard %s' % (source_folder, current commit)) #@ 


@ exists 检查 服务 器 中 是 否 有 指定 的 文件 夹 或 文件 。 我 们 指定 的 是 隐藏 文件 夹 .git， 检 查 
仓库 是 否 已 经 克隆 到 文件 夹 中 。 


@ 很 多 命令 都 以 cd 开头， 其 目的 是 设 定 当前 工作 目录 。Fabric 没有 状态 记忆 ， 所 以 下 次 
运行 run 命令 时 不 知道 在 哪个 目录 中 。” 
@ 在 现 有 仓库 中 执行 git fetch 命令 的 作用 是 从 网 络 中 拉 取 最 新 提交 。 
































注 3: 如 果 你 想 知 道 构建 路 径 为 什么 使 用 %s 而 不 用 前 面 用 过 的 os.path.jotn， 我 告诉 你 ， 因 为 在 Windows 中 
运行 这 个 脚本 ，path. join 会 使 用 反 斜 线 ， 但 在 服务 器 中 却 要 使 用 斜 线 。 
注 4: Fabric 本 身 也 提供 了 cd 函数 ， 但 我 觉得 本 章 要 多 次 用 到 这 个 函数 ， 太 喝 嗪 。 
























































使 用 Fabric 自 动 部 署 | 149 











@ 如 果 仓 库 不 存在 ， 就 执行 git clone 命令 克隆 一 份 全 新 的 源码 。 


@ Fabric 中 的 local 函数 在 本 地 电脑 中 执行 命令 ， 这 个 函数 其 实 是 对 subprocess.Popen 的 
再 包装 ， 不 过 用 起 来 十 分 方便 。 我 们 捕获 git log 命令 的 输出 ， 获 取 本 地 仓库 中 当前 提 
交 的 哈 希 值 。 这 么 做 的 结果 是 ， 服 务 器 中 代码 将 和 本 地 检 出 的 代码 版 本 一 致 (前 提 是 已 
经 把 代码 推送 到 服务 器 )。 























@ 执行 git reset --hard 命令 , 切换 到 指定 的 提交 。 这 个 命令 会 撤销 在 服务 器 中 对 代码 
仓库 所 做 的 任何 改动 。 


为 了 让 这 个 脚本 可 用 ， 你 要 执行 git push 命令 把 本 地 仓库 推送 到 代码 分 享 网 
让， 这样 服务 器 才能 拉 取 仓库 ， 再 执行 9tt reset 命令 。 如 果 你 遇 到 coutd 
not parse object 错误 ， 可 以 执行 git push 命令 试 试 。 














然后 更 新 配置 文件 ， 设 置 ALLOWED_HOSTS 和 DEBUG， 还 要 创建 一 个 密 钥 : 





deploy tools/fabfile.py 


def update_ settings(source folder, site name): 
settings_path = source folder + '/superlists/settings.py' 
sed(settings_path, "DEBUG = True", "DEBUG = False") #©0 
sed(settings_path, 
'ALLOWED_HOSTS 
'ALLOWED_HOSTS 


和 
["%s"]' % (site_nanme,) #@ 


) 
secret key file = source folder + '/superlists/secret_ key.py' 
if not exists(secret key file): #@ 
chars = 'abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(-_ =+)" 
key = ''.join(random.SystemRandom().choice(chars) for _ in range(50)) 
append(secret_key_file, "SECRET_KEY = '%s'" % (key,)) 
append(settings_path, '\nfrom .secret_ key import SECRET_KEY') #@© 





@ Fabric 提供 的 sed 函数 作用 是 在 文件 中 替换 字符 串 。 这 里 我 们 把 DEBUG 的 值 由 True 改 成 


False, 











@ 这 里 使 用 sed 调整 ALLOWED_H0OSTS 的 值 ， 使 用 正则 表达 式 匹 配 正 确 的 代码 行 。 


@ Django 有 几 处 加 密 操 作 要 使 用 SECRET_KEY: cookie 和 CSRF 保护 。 在 服务 器 中 和 (可 能 
公开 的 ) 源码 仓库 中 使 用 不 同 的 密 钥 是 个 好 习惯 。 如 果 还 没有 密 钥 ， 这 段 代 码 会 生成 一 
个 新 密 钥 ， 然 后 写 人 密 钥 文件 。 有 密 钥 后 ， 每 次 部 署 都 要 使 用 相同 的 密 钥 。 更 多 信息 参 
见 Django 文档 (https://docs.djangoproject.com/en/1.7/topics/signing/)。 











@ append 的 作用 是 在 文件 末尾 添加 一 行内 容 。( 这 个 函数 很 聪明 ， 如 果 要 添加 的 行 已 经 存 
在 ， 就 不 会 再 次 添加 ; 但 如 果 文 件 末 尾 不 是 一 个 空 行 ， 它 却 不 能 自动 添加 一 个 空 行 。 
此 我 们 加 上 了 \n。) 











A 
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@ 我 使 用 的 是 “相对 导入 ” (relative import， 使 用 from .secret key 而 不 是 from secret_ 
key)， 目 的 是 确保 从 本 地 而 不 是 从 sys.path 中 其 他 位 置 的 模块 中 导入 。 下 一 章 我 会 更 
深入 地 介绍 相对 导入 。 








有 些 人 ， 比 如 7wo Scoops of Diango 的 两 位 著名 作者 ， 建 议 使 用 环境 变量 设 
置 密 钥 等 。 你 觉得 在 你 的 环境 中 哪 种 方法 安全 ， 就 使 用 哪 种 方法 。 





接 下 来 创建 或 更 新 虚拟 环境 : 


deploy_ tools/fabfile.py 
def update virtualenv(source folder): 
virtualenv_folder = source folder + '/../virtualenv' 
if not exists(virtualenv_folder + '/bin/pip'): #©@ 
run('virtualenv --python=python3 %s' % (virtualenv_folder,)) 
run('%s/bin/pip instaLL -r %s/requirements.txt' % ( #@ 
virtualenv_folder, source folder 


)) 
@ 在 virtualenv 文件 夹 中 查找 可 执行 文件 pip， 以 此 检查 虚拟 环境 是 否 存在 。 


@ 然后 和 之 前 一 样 ， 执 行 pip install -r 命令 。 





更 新 静态 文件 只 需要 一 个 命令 : 


deploy_ tools/fabfile.py 
def Update static files(source folder): 


run('cd %s && ../virtualenv/bin/python3 manage.py collectstatic --noinput' % (#@ 
source_folder, 


)) 


@ 如 果 需 要 执行 Django 的 manage.py 命令 ， 就 要 指定 虚拟 环境 中 二 进 制 文件 夹 ， 确 保 使 
用 的 是 虚拟 环境 中 的 Django 版 本 ， 而 不 是 系统 中 的 版 本 。 

















最 后 ， 执 行 manage.py migrate 命令 更 新 数据 库 : 





deploy_ tools/fabfile.py 


def update database(source_ folder): 
run('cd %s && ../virtualenv/bin/python3 manage.py migrate --noinput' % ( 
source_folder, 


)) 


9.2 ”试用 部 署 脚本 


可 以 在 现 有 的 过 渡 服 务 器 中 试用 这 个 部 署 脚 本 一 一 这 个 脚本 可 以 在 现 有 的 服务 器 中 运行 ， 
也 可 以 在 新 服务 器 中 和 运行。 如果 你 喜欢 带 有 拉丁 语词 根 的 词 ， 可 以 把 这 个 特点 描述 为 “ 震 
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等 ”*， 也 就 是 说 ， 如 果 再 次 运行 ， 这 个 脚本 不 会 做 任何 操作 。 











$ cd deploy_tools 
$ fab deploy:host=elspeth@superlists-staging.ottg.eu 


[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[localhost] local: git log 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 


Executing task 'deploy' 

run: mkdir -p /home/elspeth/sites/superlists-stagin 
run: mkdir -p /home/elspeth/sites/superlists-stagin 
run: mkdir -p /home/elspeth/sites/superlists-stagin 
run: mkdir -p /home/elspeth/sites/superlists-stagin 
run: mkdir -p /home/elspeth/sites/superlists-stagin 
run: cd /home/elspeth/sites/superlists-staging.ottg 
n 1 --format=%H 

run: cd /home/elspeth/sites/superlists-staging.ottg 
out: HEAD is now at 85a6c87 Add a fabfile for autom 
out: 


[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 


run: sed -i.bak -r -e 's/DEBUG = True/DEBUG = False 
run: echo 'ALLOWED_HOSTS = ["superlists-staging.ott 
run: echo 'SECRET_KEY = '\\''4p2u8fi6)bltep(6nd_ 3tt 
run: echo 'from .secret key import SECRET_KEY' >> " 


[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 


run: /home/elspeth/sites/superlists-staging.ottg.eu 
out: Requirement already satisfied (use --upgrade t 
out: Requirement already satisfied (use --upgrade t 
out: Cleaning up... 

out: 


[superlists-staging.ottg.eu] run: cd /home/elspeth/sites/superlists-staging.ottg 


[superlists-staging.ottg.eu] out: 
[superlists-staging.ottg.eu] out: 0 static files copied, 11 unmodified. 
[superlists-staging.ottg.eu] out: 


[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 
[superlists-staging.ottg.eu 


run: cd /home/elspeth/sites/superlists-staging.ottg 
out: Creating tables ... 

out: Installing custom SQL ... 

out: Installing indexes ... 

out: Installed 0 object(s) from 0 fixture(s) 





[superlists-staging.ottg.eu] out: 
Done. 
Disconnecting from superlists-staging.ottg.ey... done. 


太 棒 了 。 我 喜欢 让 电脑 成 页 地 显示 这 种 输出 (事实 上 ， 我 完全 无 法 阻止 自己 制造 上 世纪 70 





年 代 的 电脑 发 出 的 “ 踊 呢 - 跋 呢 - 踊 呢 ”声音 ， 就 像 《异形 》 中 的 电脑 Mother 一 样 “)。 
果 仔 细 看 这 些 输出 ， 会 发 现 脚本 在 执行 我 们 的 命令 : 虽然 目录 结构 已 经 建 好 ,但 mkdir 











如 
-Pp 


命令 还 是 能 顺利 执行 ， 然 后 执行 git puLL 命令 ， 拉 取 我 们 刚刚 提交 的 几 次 改动 ，sed 和 
echo >> 修改 settings.py 文件 ， 然 后 顺利 执行 完 pip3 install -r requirements.txt 命令 ， 





注意 ， 现 有 的 虚拟 环境 中 已 经 安装 了 全 部 所 需 的 包 ; collectstatic 命令 发 现 静态 文人 





注 5:“ 需 等 ”的 英文 是 idempotent， 拉 丁 语 词根 是 idem。 一 一 译 者 注 
注 6: Mother 是 电影 《异形 》 系 列 中 诺 史 莫 号 的 中 央 控 制 系 统 。 一 一 译 者 注 
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也 
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收集 好 了 ;， 最 后 ， 执 行 migrate 命令 。 这 个 过 程 完全 没 障碍 。 








配置 Fabric 


如 果 使 用 SSH 密 钥 登 录 ， 密 钥 存储 在 默认 的 位 置 ， 而 且 本 地 电脑 和 服务 器 使 用 相同 的 
用 户 名 ， 那 么 无 需 配 置 即 可 直接 使 用 Fabric。 如 果 不 满足 这 几 个 条 件 ， 就 要 配置 用 户 
名 、SSH 密 钥 的 位 置 或 密码 等 ， 才 能 让 fab 执行 命令 。 


这 几 个 信息 可 在 命令 行 中 传 给 Fabric。 更 多 信息 可 执行 $ fab --hetp 命令 查看 ， 或 者 
阅读 Fabric 的 文档 (http://docs.fabfile.org/) 。 











9.2.1 部 署 到 线 上 服务 器 
下 面 在 线 上 服务 器 中 试 试 这 个 脚本 : 














$ fab deploy:host=elspeth@superlists.ottg.eu 


$ fab deploy --host=superlists.ottg.eu 

[superlists.ottg.eu] Executing task 'deploy' 

[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/databa 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/static 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/virtua 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/source 
[superlists.ottg.eu] run: git clone https://github.com/hjwp/book-example.git /ho 
[superlists.ottg.eu] out: Cloning into '/home/elspeth/sites/superlists.ottg.eu/s 
[superlists.ottg.eu] out: remote: Counting objects: 3128, done. 
[superlists.ottg.eu] out: Receiving objects: 0% (1/3128) 

[...] 

[superLists.ottg.eu] out: Receiving objects: 100% (3128/3128), 2.60 MiB | 829 Ki 
[superLists.ottg.eu] out: Resolving deltas: 100% (1545/1545), done. 
[superlists.ottg.eu] out: 


[localhost] local: git log -n 1 --format=%H 

[superlists.ottg.eu] run: cd /home/elspeth/sites/superlists.ottg.eu/source && gi 
[superlists.ottg.eu] out: HEAD is now at 6c8615b use a secret key file 
[superlists.ottg.eu] out: 


[superlists.ottg.eu] run: sed -i.bak -r -e 's/DEBUG = True/DEBUG = False/g' "$(e 
[superLists.ottg.eu] run: echo 'ALLOWED_HOSTS = ["superlists.ottg.eu"]' >> "$(ec 
[superlists.ottg.eu] run: echo 'SECRET_KEY = '\\''mqu(ffwid5vleol%ke^jil*x1imkj-4 
[superLists.ottg.eu] run: echo 'from .secret key import SECRET_KEY' >> "$(echo / 
[superlists.ottg.eu] run: virtualenv --python=python3 /home/elspeth/sites/superl 
[superlists.ottg.eu] out: Already using interpreter /usr/bin/python3 
[superlists.ottg.eu] out: Using base prefix '/usr’ 

[superlists.ottg.eu] out: New python executable in /home/elspeth/sites/superlist 
[superlists.ottg.eu] out: ALso creating executable in /home/elspeth/sites/superl 
[superlists.ottg.eu] out: Installing Setuptoots...........................， done. 
[superlists.ottg.eu] out: Installing Pip, done. 
[superlists.ottg.eu] out: 
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[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


Ei 


[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


[a 


[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


[ead 


[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


[2 


[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 
[superlists.ottg. 


Done. 


eu] 
eu] 
eu] 


eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 


eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 
eu] 


eu] 
eu] 
eu] 


eu] 
eu] 
eu] 
eu] 


eu] 
eu] 
eu] 


eu] 
eu] 
eu] 
eu] 
eu] 


run: /home/elspeth/sites/superlists.ottg.eu/source/../virtu 
out: Downloading/unpacking Django==1.7 (from -r /home/elspe 


out: Downloading Django-1.7.tar.gz (8.0MB): 


out: Downloading Django-1.7.tar.gz (8.0MB): 100% 8.0MB 


out: Running setup.py egg_info for package Django 
out: 


out: warning: no previously-included files matching 
out: warning: no previously-included files matching '*. 
out: Downloading/unpacking gunicorn==17.5 (from -r /home/el 


out: Downloading gunicorn-17.5.tar.gz (367kB): 100% 367k 


out: Downloading gunicorn-17.5.tar.gz (367kB): 367kB down 
out: Running setup.py egg_info for package gunicorn 

out: 

out: Installing collected packages: Django, gunicorn 


out: Running setup.py install for Django 


out: changing mode of build/scripts-3.3/django-admin.py 
out: 

out: warning: no previously-included files matching '__ 
out: warning: no previously-included files matching '*. 
out: changing mode of /home/elspeth/sites/superlists.ot 
out: Running setup.py install for gunicorn 

out: 

out: Installing gunicorn_paster script to /home/elspeth 
out: Installing gunicorn script to /home/elspeth/sites/ 
out: Installing gunicorn django script to /home/elspeth 


out: Successfully installed Django gunicorn 
out: Cleaning up... 
out: 


run: cd /home/elspeth/sites/superlists.ottg.eu/source && .. 
out: Copying '/home/elspeth/sites/superlists.ottg.eu/source 
out: Copying '/home/elspeth/sites/superlists.ottg.eu/source 


out: Copying '/home/elspeth/sites/superlists.ottg.eu/source 


out: 
out: 11 static files copied. 
out: 


run: cd /home/elspeth/sites/superlists.ottg.eu/source && .. 


out: Creating tables ... 
out: Creating table auth_permission 


out: Creating table lists item 

out: Installing custom SQL ... 

out: Installing indexes ... 

out: Installed 0 object(s) from 0 fixture(s) 
out: 


Disconnecting from superlists.ottg.euy... done. 








踊 呢 - 踊 呢 - 踊 呢 。 可 以 看 出 ， 这 个 脚本 执行 的 路 径 有 点 不 同 。 这 一 次 ， 执 行 git 


CLone 
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命令 克隆 一 个 全 新 的 仓库 ， 而 没有 执行 git pull; 而 且 从 零 开 始 创 建 了 一 个 新 的 虚拟 环 
境 ， 还 安装 了 pip 和 Django; collectstatic 命令 这 次 真 的 创建 了 很 多 新 文件 ，migrate 看 











起 来 也 完成 了 任务 。 


9.2.2 使 用 sed 配 置 Nginx 和 Gunicorn 


把 网 站 放 到 生产 环境 之 前 还 要 做 什么 呢 ?” 根 据 配置 笔记 ， 还 要 使 用 模板 文件 创建 Nginx 虚 





拟 主机 和 Upstart 脚本 。 使 用 Unix 命令 行 工具 完成 这 一 操作 怎么 样 ? 


elspeth@server:$ sed "s/SITENAME/superlists.ottg.eu/g" \ 
deploy_tools/nginx.template.conf | sudo tee \ 
/etc/nginx/sites-available/superlists.ottg.eu 





sed (stream editor， 流 编辑 器 ) 的 作用 是 编辑 文本 流 。Fabric 中 进行 文本 替换 的 了 国 数 也 叫 
sed， 这 并 不 是 巧合 。 这 里 ， 使 用 s/replaceme/withthis/g 句法 把 字符 串 SITENAME 替换 成 
网 站 的 地 址 。 然 后 使 用 管道 操作 (|) 把 文本 流传 给 一 个 有 root 权限 的 用 户 处 理 (sudo)， 














把 传 入 的 文本 流 写 入 一 个 文件 ， 即 sites-available 文件 夹 中 的 一 个 虚拟 主机 配置 文件 。 
现在 可 以 激活 这 个 文件 配置 的 虚拟 主机 





elspeth@server:$ sudo ln -s ../sites-available/superlists.ottg.eu \ 
/etc/nginx/sites-enabled/superlists .ottg .eu 


然后 编写 Upstart 脚本 : 
elspeth@server: sed "s/SITENAME/superlists.ottg.eu/g" \ 


deploy_tools/gunicorn-upstart.template.conf | sudo tee \ 
/etc/init/gunicorn-superlists.ottg.eu.conf 


最 后 ， 启 动 这 两 个 服务 : 


elspeth@server:$ sudo service nginx reload 
elspeth@server:$ sudo start gunicorn-superlists.ottg.eu 





现在 访问 我 们 的 网 站 。 运 行 起 来 了 ， 太 棒 了 ! 
把 fabfile.py 添加 到 仓库 中 : 


$ git add deploy_tools/fabfile.py 
$ git commit -m "Add a fabfile for automated deploys" 


9.3 使 用 Git 标 签 标注 发 布 状态 

















最 后 还 要 做 些 管理 操作 。 为 了 保留 历史 标记 ， 使 用 Git 标签 (tag) 标注 代码 库 的 状态 ， 指 








明 服 务 器 中 当前 使 用 的 是 哪个 版 本 : 
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git tag LIVE 

export TAG=`date +DEPLOYED-%F/%H%M`”# 生成 一 个 时 间 惟 
echo $TAG # 会 显示 “DEPLOYED-” 和 时间 稚 

git tag $TAG 

git push origin LIVE STAG # 推送 标签 


现在 ， 无 论 何 时 都 能 轻易 地 查看 当前 代码 库 和 服务 器 中 的 版 本 有 何 差异 。 这 个 操作 在 后 


LT LTLT LT LT 

















介绍 数据 库 迁 移 的 章节 中 也 会 用 到 。 看 一 下 提交 历史 中 的 标签 : 





$ git log --graph --oneline --decorate 


上 总之， 现在 我 们 部 署 了 一 个 线 上 网 站 。 告 诉 你 的 朋友 吧 ! 如 果 他 们 不 感 兴趣 ， 就 告诉 自 


= 








的 妈妈 ! 下 一 章 我 们 要 继续 编程 。 


9.4 ”延伸 阅读 





C 


部 署 没有 唯一 正确 的 方法 ， 而 且 我 无 论 如 何 也 算 不 上 资深 专家 。 我 试 着 把 你 领 进门 ， 但 有 
很 多 事情 可 以 使 用 不 同 的 方法 处 理 ， 还 有 很 多 很 多 的 知识 要 学 习 。 下 面 我 列 出 了 一 些 阅 读 
































材料 ， 仅 供 参 考 : 





。 Hynek Schlawack 的 文章 “Solid Python Deployments for Everybody” (https://hynek.me/ 


talks/python-deployments/) ; 


。 Dan Bravender 的 文章 “git-based fabric deploys are awesome” (http://dan.bravender.net/ 


2012/5/11/git-based_fabric_deploys_are_awesome.html) ; 
。 Dan Greenfield 和 Audrey Roy 合 著 的 Two Scoops of Django 中 与 部 署 相 关 的 章节 ， 
。 Heroku 团队 写 的 “The 12-factor App” (http://12factor.net/) 。 
































如 果 想 知道 如 何 自动 完成 配置 过 程 ， 以 及 如 何 使 用 Fabric 的 替代 品 Ansible， 请 阅读 附 





录 C。 











自动 部 署 
Fabric 
Fabric 允许 在 Python 脚本 中 编写 可 在 服务 器 中 执行 的 命令 。 这 个 工具 很 适合 自动 执 
行 服务 器 管理 任务 。 
舌 等 
如 果 部 署 脚 本 要 在 已 经 配置 的 服务 器 中 运行 ， 就 要 把 它 设计 成 既 可 在 全 新 的 服务 器 
中 运行 ， 又 能 在 已 经 配置 的 服务 器 中 运行 。 
把 配置 文件 纳入 版 本 控制 
一 定 不 能 只 在 服务 器 中 保存 一 份 配置 文件 副本 。 配 置 文件 对 应 用 来 说 非常 重要 ， 应 
该 和 其 他 文件 一 样 纳入 版 本 控制 。 





自动 配置 

最 终 ， 所 有 操作 都 要 实现 自动 化 ， 包 括 配 置 全 新 的 服务 器 和 安装 所 需 的 全 部 正确 软 
件 。 配 置 的 过 程 中 会 和 主机 供应 商 的 API 交互 。 

配置 管理 工具 

Fabric 很 灵活 ， 但 其 逻辑 还 是 基于 脚本 的 。 高 级 工具 使 用 声明 式 的 方法 ， 用 起 来 更 
方便 。Ansible 和 Vagrant 都 值得 一 试 (参见 附录 C) ， 此 外 还 有 很 多 同类 工具 ， 例 
如 Chef、Puppet、Salt 和 Juju 等 。 
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输入 验证 和 测试 的 组 织 方 式 























下 面 儿童 要 讨论 如 何 验证 用 户 的 输入 ， 以 及 如 何 测 试验 证 功能 。 借 此 机 会 ， 还 要 整理 一 下 
应 用 代码 和 测试 代码 。 


10.1 针对 验证 的 功能 测试 ， 避免 提交 空 待 办 事项 
我 们 的 网 站 开始 有 用 户 了 。 我 们 注意 到 用 户 有 时 会 犯错 ， 把 他 们 的 清单 弄 得 一 团 粳 ， 例 如 


不 小 心 提 交 空 的 待 办 事项 ， 或 者 在 一 个 清单 中 输入 两 个 相同 的 待 办 事项 。 计 算 机 能 帮助 我 
们 避免 犯 这 种 思春 的 错误 ， 看 一 下 能 否 让 网 站 提供 这 种 帮助 。 





























下 面 是 一 个 功能 测试 的 大 纲 : 








functional tests/tests.py (ch101001) 


def test_cannot_add_empty_list items(self): 
# 伊 迪 丝 访问 首页 ,不 小 心 提 交 了 一 个 空 待 办 事项 
# 输入 框 中 没 输入 内 容 , 她 就 按 下 了 回 车 键 


# 首页 刷新 了 ,显示 一 个 错误 消息 
# 提示 待 办 事项 不 能 为 空 


# 她 输入 一 些 文字 ,然后 再 次 提交 ,这 次 设 问题 了 
# 她 有 点 儿 调皮 ,又 提交 了 一 个 空 待 办 事项 
# 在 清单 页 面 她 看 到 了 一 个 类 似 的 错误 消息 

































































# 输入 文字 之 后 就 没 问题 了 
self.fail('write me!') 
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测试 写 得 很 好 ， 但 功能 测试 文件 变 得 有 点 儿 腾 肿 ， 在 继续 之 前 ， 要 把 功能 调试 分 成 多 个 文 
件 ， 每 个 文件 中 只 放 一 个 测试 方法 。 


还 记得 吗 ? 功能 测试 和 “用 户 故 事 ” 联 系 紧 密 。 如 果 使 用 问题 跟踪 程序 等 项 目 管理 工具 ， 
你 可 能 想 让 每 个 文件 对 应 一 个 问题 或 工 单 ticket) ， 而 且 文件 名 中 要 包含 工 单 的 编号 。 如 
果 你 喜欢 使 用 “功能 ”的 概念 考虑 问题 (一 个 功能 可 能 包含 多 个 用 户 故 事 )， 可 以 用 一 个 
文件 对 应 一 个 功能 ， 一 个 文件 中 只 写 一 个 测试 类 ， 每 个 用 户 故 事 使 用 多 个 测试 方法 实现 。 











还 要 编写 一 个 测试 基 类 ， 让 所 有 调试 类 都 继承 这 个 基 类 。 下 面 分 步 介 绍 分 拆 过 程 。 


10.1.1 跳 过 测试 
重 构 时 最 好 能 让 整个 测试 组 件 都 通过 。 刚 才 我 们 故意 编写 了 一 个 失败 测试 ， 现 在 要 使 用 
unittest 提供 的 修饰 器 @skip 临时 禁止 执行 这 个 测试 方法 : 

functional tests/tests.py (ch101001-1) 


from unittest import skip 


Lae] 
@skip 
def test cannot _ add empty_list items(self): 
这 个 修饰 器 告诉 测试 运行 程序 ， 多 略 这 个 测试 。 再 次 运行 功能 测试 就 会 看 到 这 么 做 起 作用 
了 ， 因 为 测试 组 件 仍 能 通过 : 





$ python3 manage.py test functionaL_tests 


Ran 3 tests in 11.577s 
OK 


跳 过 测试 很 危险 ， 把 改动 提交 到 仓库 之 前 记得 删 掉 @skip 修饰 器 。 这 就 是 逐 
行 审查 差异 的 目的 。 














别 忘 了 “ 遇 红 / 变 绿 / 重 构 ” 中 的 “ 重 构 ” 
TDD 有 时 会 被 批评 说 得 到 的 代码 架构 不 好 ， 因 为 开发 者 关注 的 是 怎么 让 测试 通过 ， 没 
有 停 下 来 思考 整个 系统 应 该 怎么 设计 。 我 觉得 这 么 说 有 点 不 公平 。 
TDD 不 是 万 能 良药 。 你 仍 要 花 时 间 考 虑 好 的 设计 。 不 过 开发 者 经 常会 忘记 “ 遇 红 / 变 
绿 / 重 构 ” 中 还 有 “ 重 构 ”这 一 步 。 使 用 TDD， 为 了 让 测试 通过 ， 可 以 随意 丢掉 旧 代 
码 ， 但 它 也 要 求 你 在 测试 通过 之 后 花 点 儿 时 间 重 构 ， 改 进 设计 。 
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不 过 ， 重 构 的 最 佳 方法 往往 不 那么 容易 想到 ， 可 能 等 到 写 下 代码 之 后 的 几 天 、 几 周 ， 
甚至 几 个 月 ， 处 理 完全 无 关 的 事情 时 ， 突 然 灵 光一 闪 才 能 想 出 来 。 在 解决 其 他 问题 的 
途中 ， 应 该 停 下 来 去 重 构 以 前 的 代码 吗 ? 


这 要 视 情 况 而 定 。 比 如 像 本 章 开始 这 种 情况 ， 我 们 还 没有 开始 编写 新 代码 ， 知 道 一 切 
都 能 正常 运行 ， 所 以 可 以 跳 过 刚 编 写 的 功能 测试 (让 测试 全 部 通过 ) ， 先 重 构 。 

在 本 章 后 面 的 内 容 中 还 会 遇 到 需要 重 构 的 代码 。 届 时 ， 我 们 不 能 冒险 在 无 法 正常 运行 
的 应 用 中 重 构 ， 可 以 在 便签 上 做 个 记录 ， 等 测试 组 件 能 全 部 通过 之 后 再 重 构 。 














10.1.2 ”把 功能 测试 分 拆 到 多 个 文件 中 
先 把 各 个 测试 方法 放 在 单独 的 类 中 ， 但 仍然 保存 在 同一 个 文件 里 : 


考 

















functional tests/tests.py (ch101002) 


class FunctionalTest(StaticliveServerCase): 


@classmethod 
def setUpClass(cls): 
[3 


@classmethod 
def tearDownClass(cls): 


def setUp(self): 


[| 
def tearDown(self): 


[...] 


def check_for_row_in list table(self, row_text): 
[sa 
class NewVisitorTest(FunctionalTest): 
def test can_start a list and_retrieve it later(self): 
|| 
class LayoutAndStylingTest(FunctionalTest): 
def test layout_and_styling(self): 
| 
class ItemValidationTest(FunctionalTest): 
@skip 
def test cannot_add_ empty_list items(self): 
[sad 
后 运行 功能 测试 ， 看 是 否 仍 能 通过 


Ran 3 tests in 11.577s 





OK 


这 么 做 可 能 有 点 劳动 量 ， 或许 能 找到 一 种 步骤 更 少 的 方法 。 但 是 ， 正 如 我 一 直 所 说 的 ， 针 


对 简单 的 情况 练习 步步为营 的 方法 ， 以 后 遇 到 复杂 的 情况 就 能 游 坟 有余。 





现在 分 拆 这 个 测试 文件 ， 一 个 类 写 入 一 个 文件 ， 而 且 还 有 一 个 文件 用 来 保存 所 有 测试 类 都 
继承 的 基 类 。 要 复制 四 份 test.py， 重 命名 各 个 文件 ， 然 后 删除 各 文件 中 不 需要 的 代码 : 





$ git mv functionaL_tests/tests.py functional_tests/base.py 


$ cp functionaL_tests/base.py functional_tests/test_simple_list_creation.py 
$ cp functionaL_tests/base.py functionaL_tests/test_Layout_and_styLing.py 
$ cp functionaL_tests/base.py functional_tests/test_list_item validation.py 


base.py 只 需 保 留 FunctionalTest 类 ， 其 他 代码 全 部 删 掉 。 留 下 基 类 中 的 辅助 方法 ， 因 为 


觉得 在 新 的 功能 测试 中 会 用 到 














functional tests/base.py (ch101003) 


from django.contrib.staticfiles.testing import StaticLiveServerCase 


from selenium import webdriver 
import sys 


class FunctionalTest(StaticLiveServerCase): 


@classmethod 

def setUpClass(cls): 

def ee 

def ee 

def ey 

def a row_text): 


[S01 











继承 ， 用 组 合 模式 。 





我 们 编写 的 第 一 个 功能 测试 现在 放 在 单独 的 文件 中 了 ， 而 且 这 个 文件 中 只 
测试 方法 : 











把 辅助 方法 放 在 FunctionalTest 基 类 中 是 避免 功能 测试 代码 重复 的 方法 之 
一 。 第 21 章 会 用 到 “页 面 模式 ”(Page pattern) ， 与 这 种 方法 有 关 ， 但 不 用 


一 个 类 和 一 个 


functional tests/test_simple list_creation.py (ch101004) 


from .base import FunctionalTest 
from selenium import webdriver 
from selenium.webdriver.common.keys import Keys 


class NewVisitorTest(FunctionalTest): 
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def test_can_start_a_List_and_retrieve_it_Later(seLf) : 
[对 
我 用 到 了 相对 导入 (from .base)， 有 些 人 喜欢 在 Django 应 用 中 大 量 使 用 这 种 导入 方式 
(例如 ， 视 图 可 能 会 使 用 from .models import List 导入 模型 ， 而 不 用 from list.models)。 
这 其 实 是 个 人 喜好 问题 ， 只 有 十 分 确定 要 导入 的 文件 位 置 不 会 变化 时 ， 我 才 会 选择 使 用 相 
对 导入 。 这 里 使 用 相对 导入 是 因为 ， 我 确定 所 有 测试 文件 都 会 和 它们 要 继承 的 base.py 放 
在 一 起 。 


针对 布局 和 样式 的 功能 测试 现在 也 放 在 独立 的 文件 和 类 中 















































functional tests/test lIayout and_styling.py (ch101005) 





from .base import FunctionalTest 


class LayoutAndStylingTest(FunctionalTest): 
Gi:s] 


刚 编写 的 验证 测试 也 放 在 单独 的 文件 中 了 : 





functional tests/test list item validation.py (ch101006) 





from unittest import skip 
from .base import FunctionalTest 


class ItemValidationTest(FunctionalTest): 
@skip 
def test cannot_add_ empty_list items(self): 
[...] 
可 以 再 次 执行 manage.py test function al_tests 命令 ， 确 保 一 切 都 正常 ， 还 要 确认 所 有 
三 个 测试 都 运行 了 : 
Ran 3 tests in 11.577s 


OK 
现在 可 以 删 掉 eskip 修饰 器 了 


functional tests/test list item validation.py (ch101007) 





class ItemValidationTest(FunctionalTest): 


def test cannot_add_ empty_list items(self): 


[可 
10.1.3 
拆 分 之 后 有 个 附带 后 行 单个 测试 文件 ， 如 下 所 示 : 
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$ python3 manage.py test functional_tests.test_ list item validation 


Fe] 


AssertionError: Write me! 























太 好 了 ， 如 果 只 关心 其 中 一 个 测试 ， 现 在 无 需 坐 等 所 有 功能 测试 都 运行 完 就 能 看 到 结 
了 。 不 过 ， 记 得 要 不 时 运行 所 有 功能 测试 ， 检 查 是 否 有 回归 。 本 书后 面 的 内 容 会 介绍 如 何 
把 这 项 任务 交 给 自动 化 持续 集成 循环 完成 。 现 在 ， 先 提交 : 








$ git status 
$ git add functional_tests 
$ git commit -m"Moved Fts into their own individual files" 


10.1.4 填充 功能 测试 


现在 开始 实现 本 章 开头 编写 的 测试 ， 至 少 先 把 前 面 的 部 分 写 好 : 





functional tests/test list item_validation.py (ch101008) 


def test_cannot_add_empty_list_ items(self): 
# 伊 迪 丝 访问 首页 ,不 小 心 提交 了 一 个 空 待 办 事项 
# 输入 框 中 没 输入 内 容 , 她 就 按 下 了 回 车 键 
seLf .browser .get(self.server_url) 
self.browser.find element by _id('id new item').send_ keys('\n') 











# 首页 刷新 了 ,显示 一 个 错误 消息 

# 提示 待 办 事项 不 能 为 空 

error = self.browser.find element_by_css_selector('.has-error') #0 
self.assertEqual(error.text, "You can't have an empty list item") 























# 她 输入 一 些 文字 ,然后 再 次 提交 ,这 次 没 问题 了 
seLf .browser .fitnd_eLement_by_ id('id_new_item' ) .send_keys('Buy milk\n') 
seLf .check_for_row_in_List_tabtLe('1: Buy milk') #@ 





# 她 有 点 儿 调 皮 , 又 提交 了 一 个 空 待 办 事项 


self.browser.find element by _id('id new item').send_keys('\n') 























# 在 列表 页 面 她 看 到 了 一 个 类 似 的 错误 消息 
self.check_for_row_ in list table('1: Buy milk') 

error = self.browser.find element_by_css_selector('.has-error') 
self.assertEqual(error.text, "You can't have an empty list item") 








# 输入 文字 之 后 就 没 问 题 了 

self.browser .find element by_id('id new item').send_keys('Make tea\n') 
self.check_for_row in list table('1: Buy milk') 
self.check_for_row_ in list table('2: Make tea') 


这 段 测试 有 儿 个 地 方 要 注意 : 





@ 指定 使 用 Bootstrap 提供 的 CSS 类 .has-error 标记 错误 文本 。Bootstrap 为 这 种 消息 提供 
了 很 多 有 用 的 样式 。 
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项 时 ， 


加 


用 了 check_for_row_in_list_table 辅助 











中 


@ 正如 预料 的 那样 ， 确 认 能 提交 待 办 二 
方法 。 


把 辅助 方法 写 在 父 类 中 是 为 了 避免 在 功能 测试 代码 中 重复 定义 。 如 果 有 一 天 决定 改变 列表 
的 实现 方式 ， 我 们 只 想 修改 一 处 功能 测试 代码 ， 而 不 想到 处 修改 多 个 功能 测试 。 


本 市 的 任务 结束 了 。 








selenium.common.exceptions.NoSuchElementException: Message: 'Unable to locate 
element: {"method":"css selector","selector":".has-error"}' ; Stacktrace: 


这 次 提交 留 给 你 自己 完成 。 这 是 你 第 一 次 独立 提交 功能 测试 。 


10.2 ”使 用 模型 层 验 证 


在 Django 中 有 两 个 地 方 可 以 执行 验证 : 一 个 是 模型 层 ， 另 一 个 位 置 较 高 ， 是 表单 层 。 只 
要 可 能 ， 我 更 喜欢 使 用 低层 验证 ， 方面 因为 我 喜欢 数据 库 和 数据 库 完整 性 规则 ， 另 一 方 
而 因为 在 这 一 层 执行 验证 更 安全 一 一 有 时 你 会 忘记 使 用 哪个 表格 验证 输入 ， 但 使 用 的 数据 
库 不 会 变 


10.2.1 重 构 单元 测试 ， 分 拆 成 多 个 文件 

要 为 模型 编写 一 个 新 测试 ， 但 在 此 之 前 ， 先 要 使 用 类 似 于 功能 测试 的 整理 方法 整理 单元 测 
试 。 二 者 之 间 有 个 区 别 ， 因 为 Lists 应 用 中 既 有 应 用 代码 也 有 测试 代码 ， 所 以 要 把 测试 放 
到 单独 的 文件 夹 中 : 






























































$ mkdir lists/tests 

$ touch lists/tests/__init__.py 

$ git mv lists/tests.py lists/tests/test_all.py 
$ git status 

$ git add lists/tests 

$ python3 manage.py test lists 

[...] 

Ran 10 tests in 0.034s 


OK 
$ git commit -m"Move unit tests into a folder with single file" 





如 果 测 试 的 输出 显示 “Ran 0 tests”， 有 可 能 是 因为 你 忘 了 创建 _init_.py 文件 一 一 必须 有 
这 个 文件 ， 否 则 测试 所 在 的 文件 夹 就 不 是 有 效 的 Python 模块 。 


现在 把 test_all.py 分 成 两 个 文件 : 一 个 名 为 test_views.py， 只 包含 视图 测试 ， 另 一 个 名 为 
test_models.py。 


























$ git mv lists/tests/test_all.py Lists/tests/test_views.py 
$ cp lists/tests/test_views.py lists/tests/test models.py 
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然后 清理 test_ models.py， 只 留 下 一 个 测试 方法 ， 所 以 导入 的 模块 也 更 少 了 : 


lists/tests/test_models.py (ch101009) 


from django.test import TestCase 
from lists.models import Item, List 


class ListAndItemModelsTest(TestCase): 
| | 





test_views.py 只 减少 了 一 个 类 : 


lists/tests/test_views.py (ch101010) 
--- a/lists/tests/test _ views.py 
+++ b/lists/tests/test views.py 
@@ -103,34 +104,3 @@ class ListViewTest(TestCase): 
self.assertNotContains(response, 'other list item 1') 
self.assertNotContains(response, 'other list item 2') 


-Class ListAndItemModelsTest(TestCase): 


- def test saving_and_retrieving items(self): 


Ei 
再 次 运行 测试 ， 确 保 一 切 正常 : 
$ python3 manage.py test lists 
es tests in 0.040s 
OK 


很 好 ! 


$ git add lists/tests 
$ git commit -m "Split out unit tests into two files" 








有 些 人 喜欢 项 目 一 开始 就 把 单元 测试 放 在 一 个 测试 文件 夹 中 ， 而 且 还 多 建 一 
个 文件 ，test_forms.py。 这 种 做 法 很 棒 。 我 只 是 想 等 到 必要 时 再 这 么 做 ， 以 
免 第 一 章 内 容 过 杂 。 


了 





























10.2.2 ”模型 验证 的 单元 测试 和 self.assertRaises 上 下 文 管理 器 
要 在 ListAndItemModelsTest 中 添加 一 个 新 测试 方法 ， 堂 试 创建 一 个 空 待 办 事项 : 


lists/tests/test_ models.py (ch101012-1) 


from django.core.exceptions import ValidationError 
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Eras 


class ListAndItemModelsTest(TestCase): 


[...] 


def test cannot_ save_empty_list items(self): 
List_ = List.objects.create() 
item = Item(list=list_ , text='') 
with self.assertRaises(ValidationError): 
item.save() 


如 果 刚 接触 Python， 可 能 从 未 见 过 with 语句 。 它 结合 “上 下 文 管理 器 ”一 
起 使 用 ， 包 装 一 段 代 码 ， 这 些 代码 的 作用 往往 是 设置 、 清 理 或 处 理 错误 。 
Python 2.5 的 发 布 说 明 (http://docs.python.org/release/2.5/whatsnew/pep-343. 
html) 中 有 很 好 的 解说 。 




















这 是 一 个 新 的 单元 测试 技术 : 如 果 想 检查 做 某 件 事 是 否 会 抛 出 异常 ， 可 以 使 用 self.assertRaises 
上 下 文 管理 器 。 此 外 还 可 写成 : 








try: 

item.save() 

self.fail('The save should have raised an exception') 
except ValidationError: 

pass 


不 过 使 用 with 语句 更 简洁 。 现 在 运行 测试 ， 看 着 它 失 败 : 





item.save() 
AssertionError: ValidationError not raised 


10.2.3 “Django 怪异 的 表现 : 保存 时 不 验证 数据 

我 们 遇 到 了 Django 的 一 个 怪异 表现 。 测 试 本 来 应 该 通过 的 。 阅 读 Django 模型 字段 的 文档 
(https://docs.djangoproject.com/en/1.7/ref/models/fields/#blank) 之 后 ， 你 会 发 现 TextField 的 
默认 设置 是 uank=Fatse， 也 就 是 说 文本 字段 应 该 拒绝 空 值 。 





但 为 什么 测试 失败 了 呢 ? 由 于 稍微 有 违 常理 的 历史 原因 (https://groups.google.com/forum/ 
#!topic/django-developers/uIhzSwWHj4c)， 保 存 数 据 时 Django 的 模型 不 会 运行 全 部 验证 。 
稍 后 我 们 会 看 到 ， 在 数据 库 中 实现 的 约束 ， 保 存 数 据 时 都 会 抛 出 异常 ， 但 SQLite 不 支持 文 
本 字段 上 的 强制 空 值 约束 ， 所 以 我 们 调用 save 方法 时 无 效 值 悄 无 声息 地 通过 了 验证 。 


有 种 方法 可 以 检查 约束 是 否 会 在 数据 库 层 执行 : 如 果 在 数据 库 层 制定 约束 ， 需 要 执行 迁移 
才能 应 用 约束 。 但 是 ，Django 知道 SQLite 不 支持 这 种 约束 ， 所 以 如 果 运 行 mnakemigrations， 
会 看 到 消息 说 没事 可 做 : 











$ python3 manage.py makemigrations 
No changes detected 
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不 过 ，Django 提供 了 一 个 方法 用 于 运行 全 部 验证 ， 即 fuLL_ctean。 下 面 我 们 把 这 个 方法 加 
入 测试 ， 看 看 是 否 有 用 : 











lists/tests/test_ models.py 


with self.assertRaises(ValidationError): 
item.save() 
item.full_clean() 


加 入 之 后 ， 测 试 就 通过 了 ， 
OK 

我 们 通过 这 个 怪异 的 表现 学 到 了 一 些 Django 的 验证 知识 。 如 果 忘 了 需求 ， 把 text 字段 的 

约束 条 件 设 为 blank=True ( 试 一 下 吧 )， 测 试 可 以 提醒 我 们 。 


10.3 在 视图 中 显示 模型 验证 错误 


下 面 尝 试 在 视图 中 处 理 模型 验证 ， 并 把 验证 错误 传 和 模板， 让 用 户 看 到 。 在 HTML 中 有 选 
示 错 误 可 以 使 用 这 种 方法 一 一 检查 是 否 有 错误 变量 传人 模板 ， 如 果 有 就 在 表单 下 方 




















甘 策 包 





lists/templates/base.html (ch101013) 


<form method="POST" action="{% block form_action %}{% endblock %}"> 
<input name="item text" id="id new_item" 
class="form-control input-lg" 
placeholder="Enter a to-do item" 
/> 
{% csrf_token %} 
{% if error %} 
<div class="form-group has-error"> 
<span class="help-block">{{ error }}</span> 
</div> 
{% endif %} 
</form> 


关于 表单 控件 的 更 多 信息 请 阅读 Bootstrap 文档 (http://getbootstrap.com/css/#forms ) 。 








把 错误 传 入 模板 是 视图 函数 的 任务 。 看 一 下 NewListTest 类 中 的 单元 测试 ， 这 里 我 要 使 用 
两 种 稍微 不 同 的 错误 处 理 模式 。 

在 第 一 种 情况 中 ， 新 建 清单 视图 有 可 能 谊 染 首 页 所 用 的 模板 ， 而 且 还 会 显示 错误 消息 。 单 
元 测试 如 下 : 





























lists/tests/test views.py (ch101014) 


class NewListTest(TestCase): 


[so 





输入 验证 和 测试 的 组 织 方式 | 167 


def test_vaLidation_errors_are_sent_back_to_home_page_tempLate(seLf) : 
response = self.client.post('/lists/new', data={'item text': ''}) 
self.assertEqual(response.status_code, 200) 
self.assertTemplateUsed(response, 'home.html') 
expected error = "You can't have an empty list item" 
self.assertContains(response, expected_error) 


编写 这 个 测试 时 ， 我 们 手动 输入 了 字符 串 形 式 的 地 址 /istsnew， 你 可 能 有 点 反感 。 在 此 
之 前 ， 我 们 已 经 在 测试 、 视 图 和 模板 中 硬 编码 了 多 个 地 址 ， 这 么 做 有 违 DRY 原则 。 我 并 
不 介意 测试 中 有 少量 重复 ， 但 视图 和 模板 中 硬 编码 的 地 址 要 引起 重视 ， 请 在 便签 上 做 个 记 
录 ， 稍 后 重 构 这 些 地 址 。 我 们 不 会 立即 开始 重 构 ， 因 为 现在 应 用 无 法 正常 运行 ， 得 先 让 应 
用 回 到 可 运行 的 状态 。 















































再 看 测试 。 现 在 测试 无 法 通过 ， 因 为 现在 视图 返回 302 重 定向 ， 而 不 是 正常 的 200 响应 : 


AssertionError: 302 != 200 








我 们 在 视图 中 调用 futl_clean() 试 试 : 














lists/views.py 


def new_list(request): 
list_ = List.objects.create() 
item = Item.objects.create(text=request.POST['item text'], list=list ) 
item.full_clean() 
return redirect('/lists/%d/' % (list_.id,)) 





看 到 这 个 视图 的 代码 ， 我 们 找到 了 一 种 避免 硬 编码 URL 的 好 方法 。 把 这 件 事 记 在 便签 上 : 


| 


) 
) 。 去 除 vtewa.py 中 硬 编 码 的 URL 
妥 


.A A As BS A A 




















器 








现在 模型 验证 会 抛 出 异常 ， 并 且 传 到 了 视图 中 : 





[...] 


File "/workspace/superlists/lists/views.py", line 11, in new_list 
item.full_clean() 

bt 

django.core.exceptions.ValidationError: {'text': ['This field cannot be 

blank.']} 

















下 面 使 用 第 一 种 错误 处 理 方案 : 使 用 try/except 检测 错误 。 遵 从 测试 山羊 的 教诲 ， 只 加 入 
try/except， 其 他 代码 都 不 动 。 测 试 会 告诉 我 们 下 一 步 要 编写 什么 代码 : 
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lists/views.py (ch101015) 


from django.core.exceptions import ValidationError 


[ss 

def new_list(request): 
List_ = List.objects.create() 
item = Item.objects.create(text=request.POST['item text'], list=list ) 
try: 


item.full_clean() 
except ValidationError: 
pass 
return redirect('/lists/%d/' % (list_.id,)) 


加 入 try/except 之 后 ， 测 试 结果 又 变 成 了 302 != 200 错误 : 


AssertionError: 302 != 200 





下 面 把 pass 改 成 演 染 模板 ， 这 么 改 还 兼 具 检 查 模板 的 功能 : 














lists/views.py (ch101016) 


except ValidationError: 
return render(request, 'home.html') 


现在 测试 告诉 我 们 ， 要 把 错误 消息 写 入 模板 : 


AssertionError: False is not true : Couldn't find 'You can't have an empty list 
item' in response 


为 此 ， 可 以 传 入 一 个 新 的 模板 变量 : 


lists/views.py (ch101017) 


except ValidationError: 
error = "You can't have an empty list item" 
return render(request, 'home.html', {"error": error}) 


不 过 ， 看 样子 没什么 用 : 





AssertionError: False is not true : Couldn't find 'You can't have an empty list 
item' in response 





让 视图 输出 一 些 信息 以 便 调试 : 











lists/tests/test views.py 


expected_ error = "You can't have an empty list item" 
print(response.content.decode()) 
self.assertContains(response, expected error) 


从 输出 的 信息 中 我 们 得 知 ， 失 败 的 原因 是 Django 转 义 了 HTML 中 的 单 引 号 (https://docs. 


djangoproject.com/en/1.7/topics/templates/#automatic-html-escaping) : 
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al 


<span class="help-block">You can&#39;t have an 
empty list item</span> 


可 以 在 测试 中 写 入 : 





expected_error = "You can&#39;t have an empty list item" 


但 使 用 Django 提供 的 辅助 函数 或 许 是 更 好 的 方法 : 





lists/tests/test_ views.py (ch101019) 


from django.utils.html import escape 


[i 


expected_error = escape("You can't have an empty list item") 
self.assertContains(response, expected_error) 


测试 通过 了 : 
Ran 12 tests in 0.047s 


OK 


确保 无 效 的 输入 值 不 会 存 入 数据 库 
继续 做 其 他 事 之 前 ， 不 知 你 是 否 注意 到 了 我 们 的 实现 有 点 逻辑 错误 ?现在 即使 验证 失败 仍 
会 创建 对 象 : 





lists/views.py 


item = Item.objects.create(text=request.POST['item text'], list=list ) 
try: 

item.full_clean() 
except ValidationError: 


[ead 
要 添加 一 个 新 单元 测试 ， 确 保 不 会 保存 空 待 办 事项 : 


lists/tests/test views.py (ch101020-1) 


class NewListTest(TestCase): 


| Wg | 

def test validation errors_are_sent_ back_to home_page_template(self): 
[| 

def test invalid list items arent_saved(self): 
self.client.post('/lists/new', data={'item text': ''}) 


self.assertEqual(List.objects.count(), 0) 
self.assertEqual(Item.objects.count(), 0) 





测试 的 结果 是 : 
[...] 


Traceback (most recent call last): 
File "/workspace/superlists/lists/tests/test views.py", line 57, in 
test_invalid_ list items_arent_saved 
self.assertEqual(List.objects.count(), 0) 
AssertionError: 1 != 0 


修正 的 方法 如 下 : 


lists/views.py (ch101020-2) 


def new_list(request): 
list_ = List.objects.create() 
item = Item(text=request.POST['item text'], list=list ) 
try: 
item.full_clean() 
item.save() 
except ValidationError: 
list_ .delete() 
error = "You can't have an empty list item" 
return render(request, 'home.html', {"error": error}) 
return redirect('/lists/%d/' % (list_.id,)) 


功能 测试 能 通过 吗 ? 


$ python3 manage.py test functional._tests.test_list item validation 
[...] 

File "/workspace/superlists/functional_ tests/test_list item validation.py", 
line 26, in test_ cannot_ add empty_list items 


| 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to locate 
element: {"method":"css selector","selector":".has-error"}' ; Stacktrace: 


不 能 完全 通过 ， 但 取得 了 一 些 进展 。 从 Line 26 那 行 我 们 能 看 出 ， 功 能 测试 的 第 一 部 分 通 
过 了 ,现在 要 处 理 第 二 部 分 ， 即 第 二 次 提交 空 待 办 事项 也 要 显示 错误 消息 。 


不 过 我 们 编写 了 一 些 可 用 的 代码 ， 那 就 做 个 提交 吧 











$ git commit -am"Adjust new list view to do model validation" 


10.4 ” ”Django 模式 : 在 泻 染 表单 的 视图 中 处理 


POST 请 求 


这 一 次 要 使 用 一 种 稍微 不 同 的 处 理 方式 ， 这 种 方式 是 Django 中 十 分 常用 的 模式 ， 在 泻 染 
表单 的 视图 中 处 理 该 视图 接收 到 的 POST 请 求 。 这 么 做 虽然 不 太 符 合 REST 架构 的 URL 规 
则 ， 却 有 个 很 大 的 好 处 : 同一 个 URL 既 可 以 显示 表单 ， 又 可 以 显示 处 理 用 户 输入 过 程 中 
遇 到 的 错误 。 
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现在 的 状况 是 ， 显 示 清 单 用 一 个 视图 和 URL， 处 理 新 建 清单 中 的 待 办 事项 用 另 一 个 视图 和 
URL。 要 把 这 两 种 操作 合并 到 一 个 视图 和 URL 中 。 所 以 ， 在 listhtml 中 ， 表 单 的 提交 目标 








lists/templates/list.html (ch101020) 
{% block form action %}/lists/{{ list.id }}/{% endblock %} 





不 小 心 又 硬 编码 了 一 个 URL， 在 便签 上 记 下 这 个 地 方 。 回 想 一 下 ，home.html 中 也 有 一 个 : 











。 去 除 viewa.py 中 硬 编码 的 URL 
。 去除 Luthtmt 的 表单 和 homehtmlt 
中 硬 编 码 的 URL 


SB "9 | 





[| i hs、 A A A 本 a ” 、 
> ut A 4 8 DN E 、 a »、4 














修改 之 后 功能 测试 随即 失败 ， 因 为 view_tist 视图 还 不 知道 如 何 处 理 POST 请 求 : 





$ python3 manage.py test functional_tests 

[Liel 

selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"css selector","selector":".has-error"}' ; Stacktrace: 
[ss] 

AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers'] 





本 节 我 们 要 进行 一 次 应 用 层 的 重 构 。 在 应 用 层 中 重 构 时 ， 要 先 修改 或 增加 单 
元 测试 ， 然 后 再 调整 代码 。 使 用 功能 测试 检查 重 构 是 否 完成 ， 以 及 一 切 能 否 
像 重 构 前 一 样 正常 运行 。 如 果 你 想 完 全 理解 这 个 过 程 ， 请 再 看 一 下 第 4 章 末 
尾 的 图 表 。 

















10.4.1 重 构 : 把 new_item 实 现 的 功能 移 到 view_list 中 
NewItenTest 类 中 的 测试 用 于 检查 把 POST 请 求 中 的 数据 保存 到 现 有 的 清单 中 ， 把 这 些 测试 
全 部 移 到 ListViewTest 类 中 ， 还 要 把 原来 的 请 求 目标 地 址 /ists/9%d/add_item 改 成 显示 清单 
的 URL: 

lists/tests/test views.py (ch101021) 


class ListViewTest(TestCase): 
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> 


注意 ， 


def test uses_ list template(self): 


[...] 


def test passes correct list to template(self): 


[...] 


def test displays_only_items for_ that_list(self): 
[...] 


def test can_save a_POST_request to _ an existing list(self): 
other_list = List.objects.create() 
correct_ list = List.objects.create() 


self.client.post( 
'/lists/%d/' % (correct list.id,), 
data={'item text': 'A new item for an existing list'} 


) 


self.assertEqual(Item.objects.count(), 1) 

New_item = Item.objects.first() 

self.assertEqual(new_item.text, 'A new item for an existing list') 
self.assertEqual(new_item.list, correct_ list) 


def test_POST_redirects_to_list_ view(self): 
other_list = List.objects.create() 
Correct_List = List.objects.create() 


response = self.client.post( 
'/lists/%d/' % (correct list.id,), 
data={'item text': 'A new item for an existing list'} 


) 


self.assertRedirects(response, '/lists/%d/' % (correct list.id,)) 


只 适用 于 POST 请 求 。 


改动 之 后 测试 的 结果 为 : 


然 


FAIL: test_ POST_redirects to list view (lists.tests.test views.ListViewTest) 


AssertionError: 200 != 302 : Response didn't redirect as expected: Response 
code was 200 (expected 302) 
[se 


FAIL: test_can_save_a_POST_request to_an existing_list 
(lists.tests.test views.ListViewTest) 
AssertionError: 0 != 1 


后 修改 view_list 函数 ， 处 理 两 种 请 求 类 型 ， 


lists/views.py (ch101022-1) 


def view list(request, list id): 
list = List.objects.get(id=list id) 
if request.method == 'POST': 
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整个 NewItemTest 类 都 没有 了 。 而 且 我 还 修改 了 重 定向 测试 方法 的 名 字 ， 明 确 表 明 


Item.objects.create(text=request.POST['item text'], list=list_ ) 
return redirect('/lists/%d/' % (list_.id,)) 
return render(request, 'list.html', {'list': list }) 


Ran 13 tests in 0.047s 


OK 


现在 可 以 删除 add_iten 视图 ， 因 为 不 再 需要 了 。 但 出 乎 意料 ， 一 些 测试 失败 了 : 





Lis] 

django.core.exceptions.ViewDoesNotExist: Could not import lists.views.add itenm. 
View does not exist in module lists.views. 

Las] 

FAILED (errors=4) 








失败 的 原因 是 ， 虽 然 删 除了 视图 ， 但 在 urls.py 中 仍然 引用 这 个 视图 。 把 引用 也 删除 : 











lists/urls.py (ch101023) 
urlpatterns = patterns('', 
url(r'^(\d+)/$', 'lists.views.view list', name='view list'), 
url(r'^new$', 'lists.views.new_ list', name='new_list'), 


) 
这 样 单元 测试 就 能 通过 了 。 运 行 所 有 功能 测试 看 看 结果 如 何 : 








$ python3 manage.py test functional_tests 


[...] 

Ran 3 tests in 15.276s 
FAILED (errors=1) 
依然 是 那个 新 功能 测试 中 的 失败 。 至 此 ， 重 构 add_iten 功能 的 任务 完成 了 。 此 时 应 该 提交 

代码 : 
$ git commit -am"Refactor list view to handle new item POSTs" 
我 是 不 是 破坏 了 “有 测试 失败 时 不 重 构 ”这 个 规则 ?本 节 可 以 这 么 做 ， 因 为 
若 想 使 用 新 功能 必须 重 构 。 如 果 有 单元 测试 失败 ， 决 不 能 重 构 。 不 过 在 本 书 


中 ， 虽 然 当前 这 个 用 户 故事 的 功能 测试 失败 了 ， 仍 然 可 以 重 构 。 如 果 你 更 喜 
欢 看 到 一 个 干净 的 测试 结果 ， 可 以 在 这 个 功能 测试 方法 加 上 @skip 修饰 器 。 












































10.4.2 ”在 view_list 视 图 中 执行 模型 验证 
把 待 办 事项 添加 到 现 有 清单 时 ， 我 们 希望 保存 数据 时 仍 能 遵守 制定 好 的 模型 验证 规则 。 为 











此 要 编写 一 个 新 单元 测试 ， 和 首页 的 单元 测试 差不多 ， 但 有 几 处 不 同 : 





lists/tests/test views.py (ch101024) 


class ListViewTest(TestCase): 


[...] 


def test validation errors_end_up_on_lists page(self): 
list = List.objects.create() 
response = self.client.post( 
'/lists/%d/' % (list_ .id,), 
data={'item text': ''} 
) 
self.assertEqual(response.status_code, 200) 
self.assertTemplateUsed(response, 'list.html') 
expected_ error = escape("You can't have an empty list item") 
self.assertContains(response, expected error) 





这 个 测试 应 该 失败 ， 因 为 视图 现在 还 没 做 任何 验证 ， 只 是 重 定向 所 有 POST 请 求 : 








self.assertEqual(response.status_code, 200) 
AssertionError: 302 != 200 








和 中 执行 验证 的 方法 如 下 : 


Ey 
党 











lists/views.py (ch101025) 


def view list(request, list id): 
list = List.objects.get(id=list id) 
error = None 


if request.method == 'POST': 

try: 
item = Item(text=request.POST['item text'], list=list ) 
item.full_clean() 
item.save() 
return redirect('/lists/%d/' % (list_.id,)) 

except ValidationError: 
error = "You can't have an empty list item" 


return render(request, 'list.html', {'list': list , 'error': error}) 


对 这 段 代 码 不 是 特别 满意 ， 是 吧 ? 确实 有 一 些 重复 的 代码 ，views.py 中 出 现 了 两 次 try/ 
except 语句 ， 一 般 来 说 不 太 好 看 。 





Ran 14 tests in 0.047s 


OK 














稍 等 一 会 儿 再 重 构 ， 因 为 我 们 知道 验证 待 办 事项 重复 的 代码 有 点 不 同 。 先 把 这 件 事 记 在 便 
签 上 : 
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。 去 除 weuuspyg 中 硬 编 码 的 URL 

。 去 除 Lut.html 的 表单 和 home.html 
中 硬 编 码 的 URL 

。 去 除 视图 中 验证 遇 辑 里 的 重复 


是 站 ] 





Ap A 

















制定 “ 事 不 过 三 ,三 则 重 构 ”这 个 规则 的 原因 之 一 是 ， 只 有 过 到 三 次 且 每 次 
都 稍 有 不 同时 ， 才 能 更 好 地 提炼 出 通用 功能 。 如 果 过 早 重 构 ， 得 到 的 代码 可 
能 并 不 适用 于 第 三 次 。 























至 少 功能 测试 又 可 以 通过 了 
$ python3 manage.py test functional_tests 


OK 





又 回 到 了 可 正常 运行 的 状态 ， 因 此 可 以 看 一 下 便签 上 的 记录 了 。 现 在 是 提交 的 好 时 机 。 或 
许 还 可 以 喝 杯 茶 休 息 一 下 。 


$ git commit -am"enforce model validation in list view" 


10.5 重 构 : 去 除 硬 编码 的 URL 


还 记得 urls.py 中 name= 参数 的 写法 吗 ?” 直 接 从 Django 生成 的 默认 URL 映射 中 复制 过 来， 
然后 又 给 它们 起 了 有 意义 的 名 字 。 现 在 要 查 明 这 些 名 字 有 什么 用 。 
lists/urls.py. 


url(r'^(\d+)/$', 'lists.views.view list', name='view list'), 
url(r'^new$', 'lists.views.new list', name='new_list'), 


10.5.1 模板 标签 {% url %} 
可 以 把 home.html 中 硬 编码 的 URL 换 成 一 个 Django 模板 标签 ， 再 引用 URL 的 “名 字 ”: 




















lists/templates/home.html (ch101026-1) 
{% block form action %}{% url 'new_list' %}{% endblock %} 
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然后 确认 改动 之 后 不 会 导致 单元 测试 失败 : 


$ python3 manage.py test lists 
OK 


继续 修改 其 他 模板 。 传 人 了 一 个 参数 ， 所 以 这 一 个 更 有 趣 : 


lists/templates/list.html (ch101026-2) 
{% block form action %}{% url 'view list' list.id %}{% endblock %} 





详情 请 阅读 Django 文档 中 对 URL 反 向 解析 的 介绍 (https://docs.djangoproject.com/en/1.7/ 
topics/http/urls/#reverse-resolution-of-urls ) 。 
再 次 运行 测试 ， 确 保 都 能 通过 : 

$ python3 manage.py test lists 


OK 


$ python3 manage.py test functionaL_tests 
OK 


太 棒 了 ， 做 次 提交 : 


$ git commit -am"Refactor hard-coded URLs out of templates" 








。 去 除 views.py 中 硬 编 码 的 URL 


。 去 除 视 图 中 验证 遇 辑 里 的 重复 


WW Wy | 





Lo A ee "A A 











10.5.2” 重 定 同时 使 用 get_absolute_url 


下 面 来 处 理 views.py。 在 这 个 文件 中 去 除 硬 编码 的 URL， 可 以 使 用 和 模板 一 样 的 方法 一 一 
写 入 URL 的 名 字 和 一 个 位 置 参数 : 





lists/views.py (ch101026-3) 


def new_list(request): 
[...] 


return redirect('view list', list_ .id) 
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修改 之 后 单元 测试 和 功能 测试 仍 能 通过 ， 但 是 redirect 函数 的 作用 远 比 这 强大 。 在 
Django 中 ， 每 个 模型 对 象 都 对 应 一 个 特定 的 URL， 因 此 可 以 定义 一 个 特殊 的 国 数 ， 命 名 
为 get_absotute_urL， 其 作用 是 获取 显示 单个 模 这 个 函数 在 这 里 很 
有 用 ， 在 Django 管理 后 台 (本 书 不 会 介绍 管理 后 台 ， 但 稍 后 你 可 以 自己 学 习 ) 也 很 有 用 : 
在 后 台 查 看 一 个 对 象 时 可 以 直接 跳 到 前 台 显示 该 对 象 的 页 面 。 如 果 有 必要 ， 我 总 是 建议 在 
模型 中 定义 get_absolute_url 国 数 ， 这 花 不 了 多 少时 间 。 


先 在 test_models.py 中 编写 一 个 超级 简单 的 单元 测试 : 
































lists/tests/test models.py (ch101026-4) 


def test get absolute url(self): 
list = List.objects.create() 
self.assertEqual(list_.get_absolute _ url(), '/lists/%d/' % (list_.id,)) 

















得 到 的 测试 结果 是 : 
AttributeError: 'List' object has no _ attribute 'get_absoLute_UrtL' 
实现 这 个 函数 时 要 使 用 Django 中 的 reverse 函数 。reverse 函数 的 功能 和 Django 对 urls. 


py 所 做 的 操作 相反 (参见 文档 ， 地 址 : https://docs.djangoproject.com/en/1.7/topics/http/ 


urls/#reverse-resolution-of-urls ) 。 


lists/models.py (ch101026-5) 


from django.core.urlresolvers import reverse 


class List(models.Model): 


def get_ absolute url(self): 
return reverse('view list', args=[self.id]) 





现在 可 以 在 视图 中 使 用 get_absolute_url 函数 了 一 一 只 需 把 重 定向 的 目标 对 象 传 给 
redirect 国 数 即 可 ，redirect 国 数 会 自动 调用 get_absolute_url 国 数 。 

















lists/views.py (ch101026-6) 


def new_list(request): 


[...] 


return redirect(list ) 


更 多 信息 参见 Django 文档 et 1.7/topics/http/shortcuts/#redirect) 。 
快速 确认 一 下 单元 测试 是 否 仍 能 


OK 


然后 使 用 同样 的 方法 修改 view_list 视图 : 
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lists/views.py (ch101026-7) 


def view list(request, list id): 


[条 


item.save() 
return redirect(list ) 
except ValidationError: 
error = "You can't have an empty list item" 


分 别 运行 全部 单元 测试 和 功能 测试 ， 确 保 一 切 仍 能 正常 运行 : 





$ python3 manage.py test lists 
OK 


$ python3 manage.py test functionaL_tests 
OK 


把 已 解决 问题 从 便签 上 划 掉 : 











) 6 站 

< 。 去 除 btzthtmb 的 表单 和 tronvedtmt 

R 中 硬 编 码 的 HRE- 

Q 。 去除 视 图 中 验证 进 辑 里 的 重复 

9 

A A A > ~ 











日 


是 交 一 次 : 


ot 


$ git commit -am"Use get_absoLute_urL on List model to DRY urls in views" 


最 后 一 个 待 办 事项 是 下 一 章 的 话题 。 
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关于 组 织 测试 和 重 构 的 小 贴 士 
。 把 测试 放 在 单独 的 文件 夹 中 
就 像 使 用 多 个 文件 保存 应 用 代码 一 样 ， 也 应 该 把 测试 放 到 多 个 文件 中 。 


。 使 用 一 个 名 为 tests 的 文件 夹 ， 在 其 中 添加 init .py 文件 ， 导 入 所 有 测试 类 。 

。 对 功能 测试 来 说 ， 按 照 特定 功 能 或 用 户 故 事 的 方式 组 织 。 

。 对 单元 测试 来 说 ,针对 一 个 源码 文件 的 测试 放 在 一 个 单独 的 文件 中 。 在 Django 中 ， 
往往 有 test_models.py、test_views.py 和 test_forms.py。 

。 每 个 函数 和 类 都 至 少 有 一 个 占 位 测试 。 


。 别 忘 7 了 “ 遇 红 / 变 绿 / 重 构 ”中 的 “ 重 构 ” 
编写 测试 的 主要 目的 是 让 你 重 构 代码 | 一 定 要 重 构 ， 尽 量 把 代码 变 得 简洁 。 


必 








。 测试 失败 时 别 重 构 
。 一 般 情 况 下 如 此 。 
。 不 算 正在 处 理 的 功能 测试 。 
。 如 果 测 试 的 对 象 还 没 实现 ， 可 以 先 在 测试 方法 加 上 @skip 修饰 器 。 
。 更 一 般 的 做 法 是 ， 记 下 想 重 构 的 地 方 ， 完 成 手头 上 的 活 ， 等 应 用 处 于 可 正常 运 





行 的 状态 时 再 重 构 。 
。 提交 代码 之 前 别 忘 了 删 掉 所 有 @skip 修饰 器 ! 你 应 该 始终 逐 行 审查 差异 ， 技 出 
这 种 问题 。 
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第 11 章 





简单 的 表单 














前 一 章 结 尾 提 到 ， 视 图 中 处 理 验 证 的 代码 有 太 多 重复 。Django 鼓励 使 用 表单 类 验证 用 户 的 

















输入 ， 以 及 选择 显示 错误 消息 。 本 章 介绍 如 何 使 用 这 种 功能 。 











除 此 之 外 本 章 还 会 花 点 时 间 整 理 单元 测试 ， 确 保 一 个 单元 测试 一 次 只 测试 一 件 事 。 











11.1 把 验证 逻辑 移 到 表单 中 








单 或 模型 类 的 方法 中 ， 或 者 把 业务 逻辑 移 到 Django 之 外 的 模型 中 ? 


Django 中 的 表单 功能 很 多 很 强大 : 


。 可 以 处 理 用 户 输入 ， 并 验证 输入 值 是 否 有 错误 ， 
。 可 以 在 模板 中 使 用 ， 用 来 这 染 HTMLinput 元 素 和 错误 消息 ，; 
。 稍 后 会 见识 到 ， 某 些 表单 甚至 还 可 以 把 数据 存 信 数据库。 


没 必 要 在 每 个 表单 中 都 使 用 这 三 种 功能 。 你 可 以 自己 编写 表单 的 HIML， 或 者 
据 存储 ， 但 表单 是 放置 验证 逻辑 的 绝 佳 位 置 。 








由 


在 Django 中， 视图 很 复杂 就 说 明 有 代码 异味 。 你 要 想 ， 能 否 把 逻辑 移 到 表 


自己 处 到 





E 数 
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11.1.1 使 用 单元 测试 探索 表单 API 
我 们 要 在 一 个 单元 测试 中 实验 表单 的 用 法 。 我 的 计划 是 逐步 迭代 ， 最 终 得 到 一 个 完整 的 解 
决 方案 。 希望 在 这 个 过 程 中 能 由 浅 入 深 地 介绍 表单 ， 即 便 你 以 前 从 未 用 过 也 能 理解 。 
































首先 ， 新 建 一 个 文件 ， 用 于 编写 表单 的 单元 测试 。 先 编写 一 个 测试 方法 ， 检 查 表单 的 HTML: 











lists/tests/test forms.py 
from django.test import TestCase 


from lists.forms import ItemForm 


class ItemFormTest(TestCase): 


def test form renders_ item text input(self): 
form = ItemForm() 
self.fail(form.as_p()) 





form.as_p() 的 作用 是 把 表单 泻 染 成 HTML。 这 个 单元 测试 使 用 self.fail 探索 性 编程 。 在 
manage.py shell 会 话 中 探索 编程 也 很 容易 ， 不 过 每 次 修改 代码 之 后 都 要 重新 加 载 。 














下 面 编写 一 个 极 简 的 表单 ， 继 承 自 基 类 Form， 只 有 一 个 字段 item_text: 

















lists/forms.py 
from django import forms 


class ItemForm(forms.Form): 
item text = forms.CharField() 


运行 测试 后 会 看 到 一 个 失败 消息 ， 告 诉 我 们 自动 生成 的 表单 HTML 是 什么 样 : 








self.fail(form.as_p()) 
AssertionError: <p><label for="id item text">Item text:</label> <input 
id="id_ item text" name="item text" type="text" /></p> 








自动 生成 的 HTML 已 经 和 base.html 中 的 表单 HTML 很 接近 了 ， 只 不 过 没有 placeholder 
属性 和 Bootstrap 的 CSS 类 。 再 编写 一 个 单元 测试 方法 ， 检 查 placeholder 属性 和 CSS 类 : 

















lists/tests/test forms.py 
class ItemFormTest(TestCase): 


def test form item input_ has_placeholder _and_css_classes(self): 
form = ItemForm() 
self.assertIn('placeholder="Enter a to-do item"', form.as_p()) 
self.assertIn('class="form-control input-1lg"', form.as_p()) 








这 个 测试 会 失败 ， 表 明 我 们 需要 真正 地 编写 一 些 代 码 了 。 应 该 怎么 定制 表单 字段 的 内 容 
呢 ? 答案 是 使 用 widget 参数 。 加 入 placeholder 属性 的 方法 如 下 : 














lists/forms.py 


class ItemForm(forms.Form): 
item text = forms.CharField( 
widget=forms.fields.TextInput(attrs={ 
'placeholder': 'Enter a to-do item', 
}), 
) 


修改 之 后 测试 的 结果 为 : 
AssertionError: 'class="form-control input-lg"' not found in '<p><label 


for="id_item text">Item text:</label> <input id="id_item text" name="item_ text" 
placeholder="Enter a to-do item" type="text" /></p>' 


继续 修改 : 


lists/forms.py 


widget=forms.fields.TextInput(attrs={ 
'placeholder': 'Enter a to-do item', 
'class': 'form-control input-Lg' ， 


})， 














如 果 表 单 中 的 内 容 很 多 或 者 很 复杂 ， 使 用 widget 参数 定制 很 麻烦 ， 此 时 可 
以 借助 django-crispy-forms (https://django-crispy-forms.readthedocs.org/) 和 





django-floppyforms (http://django-floppyforms.readthedocs.org/) 。 








开发 驱动 测试 :使 用 单元 测试 探索 性 编程 
上 述 过 程 是 不 是 有 点 像 开发 驱动 测试 ? 偶尔 这 么 做 其 实 没 问题 。 


探索 新 API 时 ， 完 全 可 以 先 抛 开 规 则 的 束缚 ， 然 后 再 回 到 严格 的 TDD 流程 中 。 你 可 
ws eg 
这 些 代 码 ， 然 后 使 用 合理 的 方式 重 写 ) 。 


其 实 ， 现 在 我 们 只 是 使 用 单元 测试 试验 表单 API， 这 是 学 习 如 何 使 用 API 的 好 方法 。 











11.1.2 换 用 Django 中 的 ModelForm 类 
下 Django te 
类 ， 用 来 自动 生成 模型 的 表单 ， 这 个 类 是 ModelForm。 从 下 面 的 代码 能 看 出 ， 我 们 要 使 用 
一 个 特殊 的 属性 Meta 配置 表单 : 





lists/forms.py 


from django import forms 
from lists.models import Item 
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class ItemForm(forms .modeLs.ModeLForm) : 
class Meta: 


model = Item 
fields = ('text',) 


我 们 在 Meta 中 指定 这 个 表单 用 于 哪个 模型 ， 以 及 要 使 用 哪些 字段 。 








ModeLForms 很 智能 ， 能 完成 各 种 操作 ， 例 如 为 不 同类 型 的 字段 生成 合适 的 input 类型， 以 及 
应 用 默认 的 验证 。 详 情 参 见 文档 (https://docs.djangoproject.com/en/1.7/topics/forms/modelforms/)。 








现在 表单 的 HTML 不 一 样 了 : 





AssertionError: 'placeholder="Enter a to-do item"' not found in '<p><label 
for="id_text">Text:</label> <textarea cols="40" id="id_text" name="text" 
rows="10">\r\n</textarea></p>" 


placeholder 属性 和 CSS 类 都 不 见 了 ， mee tt text" 变 成 了 name="text"。 这 些 变 
化 能 接受 ,但 普通 的 输入 框 变 成 了 textarea， 这 可 不 是 应 用 UI 想 要 的 效果 。 幸 好 ， 和 普 
通 的 表单 类 似 ，ModelForn 的 字段 也 能 使 用 widget 参数 定制 : 











lists/forms.py 
class ItemForm(forms.models.ModelForm): 


class Meta: 
model = Item 
fields = ('text',) 
widgets = { 
'text': forms.fields.TextInput(attrs={ 
'placeholder': 'Enter a to-do item', 
'class': 'form-control input-1lg', 


】])， 
定制 后 测试 通过 了 。 
11.1.3 ”测试 和 定制 表单 验证 


现在 我 们 看 一 下 ModeLForm 是 否 应 用 了 模型 中 定义 的 验证 规则 。 我 们 还 会 学 习 如 何 把 数据 
传人 表单 ， 就 像 用 户 输入 的 一 样 











lists/tests/test forms.py (ch111008) 


def test form validation for_blank_items(self): 
form = ItemForm(data={'text': ''}) 
form.save() 

















测试 的 结果 为 : 


VaLueError: The Item could not be created because the data didn't vaLidate 








区 
并 
起 
涡 
Sr 
虑 
就 
3 
hl 


事项 ， 表 单 不 会 保存 数据 。 


现在 看 一 下 表单 能 否 显示 指 定 的 错误 销 息 。 在 尝试 保存 数据 之 前 检查 验证 是 否 通 过 的 API 
是 is_valid 国 数 : 





lists/tests/test forms.py (ch111009) 


def test form validation for_blank_items(self): 
form = ItemForm(data={'text': ''}) 
self.assertFalse(form.is_ valid()) 
self.assertEqual( 
form.errors['text'], 
["You can't have an empty list item"] 


) 





调用 form.is_valid() 得 到 的 返回 值 是 True 或 Fatse， 不 过 还 有 个 附带 效果 ， 即 验证 输入 
的 数据 ， 生 成 errors 属性 。errors 是 个 字典 ， 把 字段 的 名 字 映 射 到 该 字段 的 错误 列表 上 
(一 个 字段 可 以 有 多 个 错误 ) 。 


测试 的 结果 为 : 








AssertionError: ['This field is required.'] != ["You can't have an empty list 
item"] 











Django 已 经 为 显示 给 用 户 查 看 的 错误 消息 提供 了 默认 值 。 急 着 开发 Web 应 用 的 话 ， 可 以 
直接 使 用 默认 值 。 不 过 我 们 比较 在 意 ， 想 让 错误 消息 特殊 一 些 。 定 制 错 误 消 息 可 以 修改 


Meta 的 另 一 个 变量 ，error_messages: 





lists/forms.py (ch111010) 
class Meta: 
model = Item 
fields = ('text',) 


widgets = { 
'text': forms.fields.TextInput(attrs={ 
'placeholder': 'Enter a to-do item', 
'class': 'form-control input-lg', 
】])， 
} 
error_messages = { 
'text': {'required': "You can't have an empty list item"} 
} 
然后 测试 即 可 通过 : 


OK 


知道 如 何 避 免 让 这 些 错误 消息 搅乱 代码 吗 ” 使 用 常量 : 








lists/forms.py (ch111011) 


EMPTY_LIST_ERROR = "You can't have an empty list item" 
| eg 


error_messages = { 
'text': {'required': EMPTY_LIST_ERROR} 
} 


再 次 运行 测试 ， 确 认 能 通过 。 好 的 ， 然 后 修改 测试 : 


lists/tests/test forms.py (ch111012) 


from Lists.forms import EMPTY_LIST_ERROR, ItemForm 
[...] 


def test form validation for_blank_items(self): 
form = ItemForm(data={'text': ''}) 
self.assertFalse(form.is_valid()) 
self.assertEqual(form.errors['text'], [EMPTY_LIST_ERROR]) 


修改 之 后 测试 仍 能 通过 : 


OK 


很 好 。 提 交 : 


$ git status # 会 看 到 lists/forms.py 和 tests/test_forms.py 
$ git add lists 
$ git commit -m "new form for list items" 


11.2 在 视图 中 使 用 这 个 表单 


一 开始 我 想 继续 编写 这 个 表单 ， 除 了 空 值 验证 之 外 再 捕获 唯一 性 验证 错误 。 不 过 ， 精 益 
理论 中 的 “尽早 部 署 ” 有 个 推论 ， 即 “尽早 合并 代码 ”。 也 就 是 说 ， 编 写 表单 可 能 要 花 很 
多 时 间 ， 不 断 添加 各 种 功能 一 一 我 知道 这 一 点 是 因为 我 在 撰写 本 童 草稿 时 就 是 这 么 做 的 ， 
做 了 各 种 工作 ， 得 到 一 个 功能 完善 的 表单 类 ， 但 发 布 应 用 后 才 发 现 大 多 数 功能 实际 并 不 





















































因此 ， 要 尽早 试用 新 编写 的 代码 。 这 么 做 能 避免 编写 用 不 到 的 代码 ， 还 能 尽早 在 现实 的 环 
绕 中 检验 代码 。 














我 们 编写 了 一 个 表单 类 ， 它 可 以 泻 染 一 些 HTML， 而且 至 少 能 验证 一 种 错误 一 一 下 面 我 们 
就 来 使 用 这 个 表单 吧 ! 既然 可 以 在 base.html 模板 中 使 用 这 个 表单 ， 那 么 在 所 有 视图 中 都 可 
以 使 用 。 
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11.2.1 在 处 理 GET 请 求 的 视图 中 使 用 这 个 表单 


先 修改 首页 视图 的 单元 测试 ， 使 用 Django 测试 客户 端 编写 两 个 新 测试 代替 原来 的 test_ 
home_page_returns_correct_htmL 和 test_root_url_resolves_to_home ”page_view。 但 先 不 


删除 这 两 个 旧 测 试 方法 ， 以 便 确保 新 编写 的 测试 和 旧 测 试 等 效 : 





























lists/tests/test_ views.py (ch111013) 


from lists.forms import ItemForm 
class HomePageTest(TestCase) : 


def test_root_UrL_resoLves_to_home_page_view(seLf ) : 


[2 可 


def test_home_page_returns_correct_htmL(seLf) : 
request = HttpRequest() 
[3d] 


def test home page_renders_home_ template(self): 
response = self.client.get('/') 
self.assertTemplateUsed(response, 'honme.html') #@ 


def test home page uses item form(self): 
response = self.client.get('/') 
self.assertIsInstance(response.context['form'], ItemForm) #@ 


@ 使 用 辅助 方法 assertTemplateUsed 替换 之 前 手动 测试 模板 的 代码 。 
@ 使 用 assertIsInstance 确认 视图 使 用 的 是 正确 的 表单 类 。 
测试 的 结果 为 : 











KeyError: 'form' 


I 


因此 ， 要 在 首页 视图 中 使 用 这 个 表单 : 





lists/views.py (ch111014) 
[...] 


from lists.forms import ItemForm 
from lists.models import Item, List 


def home_page(request): 
return render(request, 'home.html', {'form': ItemForm()}) 




















好 了 ， 下 面 尝试 在 模板 中 使 用 这 个 表单 一 一 把 原来 的 <input . .> 替换 成 {{ form. text }}: 


lists/templates/base.html (ch111015) 


<form method="POST" action="{% block form action %}{% endblock %}"> 
{{ form.text }} 
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{% csrf_token %} 
{% if error %} 
<div class="form-group has-error"> 





{{ form.text }} 只 会 泻 染 这 个 表单 中 的 text 字段 ， 生 成 HTML ;input 元 素 。 


现在 ， 那 两 个 旧 测 试 过 时 了 : 


self.assertEqual(response.content.decode(), expected_html) 
AssertionError: '<!D0[596 chars] <input class="form-control input-Lg" 
id="[342 chars]l>\n' != '<!DO[596 chars] \n \n 
[233 chars]L>Nn' 


这 个 失败 消息 不 易 读 ， 把 它 变 得 清晰 一 些 : 


lists/tests/test views.py (ch111016) 


class HomePageTest(TestCase) : 

maxDiff = None #©O 

[sss] 

def test home page_returns_correct_html(self): 
request = HttpRequest() 
response = home_page(request) 
expected_html = render_to_string('home.html') 
self.assertMultiLineEqual(response.content.decode(), expected_html) #@ 


@ 对 比 长 字符 串 时 assertMultiLineEqual 很 有 用 ， 它 会 以 差异 的 格式 显示 输出 ， 不 过 默认 
情况 下 会 截断 较 长 的 差异 …… 


@ …… 所 以 才 要 在 测试 类 中 设 定 maxDiff = None。 








现在 能 看 请 了 ， 测 试 失败 的 原因 是 render_to_string 函数 不 知道 怎么 处 理 表 单 : 








<form method="POST" action="/lists/new"> 
- <input class="form-control input-lg" id="id_ text" 
name="text" placeholder="Enter a to-do item" type="text" /> 


Ed 
可 以 修正 这 个 问题 : 


lists/tests/test views.py 


def test home page_returns_correct_html(self): 
request = HttpRequest() 
response = home_page(request) 
expected_html = render_to_string('home.html', {'form': ItemForm()}) 
self.assertMultiLineEqual(response.content.decode(), expected_ html) 


修改 之 后 测试 又 能 通过 了 。 确 定 添加 新 测试 前 后 的 表现 一 至 后， 可 以 删 掉 那 两 个 旧 测 试 方 
法 了。 新 测试 方法 中 的 assertTemplateUsed 和 response.context 对 一 个 处 理 GET 请 求 的 
简单 视图 而 言 足 够 了 。 
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现在 HomePageTest 类 中 只 有 如 下 两 个 测试 方法 : 
lists/tests/test_ views.py (ch111017) 


class HomePageTest(TestCase) : 


def test home page_renders_home_ template(self): 


[...] 


def test home page_uses item form(self): 


Ee 


11.2.2 ”大 量 查找 和 替换 


前 文 我 们 修改 了 表单 ，id 和 name 属性 的 值 变 了 。 运 行 功 能 测试 时 你 会 看 到 ， 首 次 尝试 查 
找 输入 框 时 测试 失败 了 : 








selenium.common.exceptions.NoSuchElementException: Message: 'Unable to locate 
element: {"method":"id","selector":"id new item"}' ; Stacktrace: 


得 修正 这 个 问题 ， 为 此 要 大 量 查 找 和 替换 。 在 此 之 前 先 提 交 ， 把 重 命名 和 逻辑 变动 区 分 开 : 





$ git diff # 审查 home.htmL,views.py 及 其 测试 中 的 改动 
$ git commit -am "use new form in home_page, simplify tests. NB breaks stuff" 











下 面 来 修正 功能 测试 。 通 过 grep 命令 我 们 得 知 ， 有 很 多 地 方 都 使 用 了 id_new_item: 











$ grep id_new item functional_tests/test* 


functional_tests/test_layout_and_styling.py: inputbox = 
self.browser.find_element_ by_id('id new_item') 
functional_tests/test_layout_and_styling.py: inputbox = 


self.browser.find_element_ by_id('id new_item') 
functional_tests/test_list item validation.py: 
self.browser.find element by _id('id new item').send_ keys('\n') 


Ei 
这 表明 我 们 要 重 构 。 在 base.py 中 定义 一 个 新 辅助 方法 : 








functional tests/base.py (ch111018) 


class FunctionalTest(StaticlLiveServerCase): 


Li 
def get item input box(self): 
return self.browser.find element_ by_id('id text') 


然后 所 有 需要 替换 的 地 方 都 使 用 这 个 辅助 方法 
est pont pn tliis py 公 直 两 不 eta dlidaticnipy 全 成 由 不- 俩 如 : 





test_simple_list_creation.py 修改 三 处 ， 





functional tests/test simple list creation.py 





# 应 用 邀请 她 输入 一 个 待 办 事项 
inputbox = self.get item input_box() 
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以 及 : 


functional tests/test list item_validation.py 





# 输入 框 中 没 输入 内 容 , 她 就 按 下 了 回 车 键 
seLf .browser .get(self.server_url) 
self.get item input_box().send_keys('\n') 








我 不 会 列 出 每 一 处 ， 相 信 你 自己 能 搞定 ! 你 可 以 再 执行 一 遍 grep， 看 是 不 是 全 都 改 了 。 





第 一 步 完 成 了 ， 接 下 来 还 要 修改 应 用 代码 。 我 们 要 找到 所 有 旧 的 id (id_new_item) 和 
name (item_text)， 分别 赫 换 成 id_text 和 text: 


$ grep -r id_new_item lists/ 
lists/static/base.css:#id new_ item { 


只 要 改动 一 处 。 使 用 类 似 的 方法 查看 name 出 现 的 位 置 : 


$ grep -Ir item text lists 


lists/views.py: item = Item(text=request.POST['item text'], list=list ) 
lists/views.py: item = Item(text=request.POST['item text'], 
lists/tests/test_views.py: data={'item text': 'A new list item’'} 
lists/tests/test_views.py: data={'item text': 'A new list item’'} 
lists/tests/test_views.py: response = self.client.post('/lists/new', 
data={'item text': ''}) 

[...] 

















改 完 之 后 再 运行 单元 测试 ， 确 保 一 切 仍 能 正常 运行 : 





$ python3 manage.py test lists 
Creating test database for alias 'default'... 


Ran 17 tests in 0.126s 


OK 
Destroying test database for alias 'default'... 


然后 还 要 运行 功能 测试 : 


$ python3 manage.py test functional_tests 
[La] 
File "/workspace/superlists/functional_ tests/test_simple list creation.py", 
line 40, in test _ can_start_a_list and_retrieve it later 
return self.browser.find element_ by_id('id text') 
File "/workspace/superlists/functional_ tests/base.py", line 31, in 
get_item input_box 
return self.browser.find element_ by_id('id text') 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id text"}' ; Stacktrace: 
| Ws] 
FAILED (errors=3) 





不 能 全 部 通过 。 确 认 一 下 发 生 错 误 的 位 置 一 一 查看 其 中 一 个 失败 所 在 的 行 号 ， 你 会 发 现 ， 
一 个 待 办 事项 后 ， 清 单 页面 都 不 会 显示 输入 框 。 
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查看 views.py 和 new_tist 视图 后 我 们 找到 了 原因 一 一 如 果 检 测 到 有 验证 错误 ， 根 本 就 不 会 
把 表单 传人 home.html 模板 ; 


lists/views.py 


except ValidationError: 
error = "You can't have an empty list item" 
return render(request, 'home.html', {"error": error}) 


我 们 也 想 在 这 个 视图 中 使 用 ItemForm 表单 。 继 续 修改 之 前 ， 先 提交 : 





$ git status 
$ git commit -am"rename all item input ids and names. still broken" 


11.3 在 处 理 POST 请 求 的 视图 中 使 用 这 个 表单 


现在 要 调整 new_list 视图 的 单元 测试 ， 更 确切 地 说 ， 要 修改 针对 验证 的 那个 测试 方法 。 先 
看 一 下 这 个 测试 方法 : 








lists/tests/test views.py 


class NewListTest(TestCase): 


[i 


def test validation errors_are_sent back_to_home_page_templatel(self): 
response = self.client.post('/lists/new', data={'text': ''}) 
self.assertEqual(response.status_code, 200) 
self.assertTemplateUsed(response, 'home.html') 
expected_error = escape("You can't have an empty list item") 
self.assertContains(response, expected error) 


11.3.1 修改 new_List 视 图 的 单元 测试 
首先 ， 这 个 测试 方法 测试 的 内 容 太 多 了 ， 所 以 借 此 机 会 可 以 清理 一 下 。 我 们 应 该 把 这 个 测 
试 方法 分 成 两 个 不 同 的 断言 : 






































。 如 果 有 验证 错误 ， 应 该 泻 染 首页 模板 ， 并 且 返 回 200 响应 ， 
。 如 果 有 验证 错误 ， 响 应 中 应 该 包含 错误 消息 。 








此 外 ， 还 可 以 添加 一 个 新 断言 : 
。 如 果 有 验证 错误 ， 应 该 把 表单 对 象 传人 模板 。 





不 用 硬 编码 错误 消息 字符 串 ， 而 要 使 用 一 个 常量 : 











lists/tests/test views.py (ch111023) 


from Lists.forms import ItemForm, EMPTY_LIST_ERROR 
[oi] 


class NewListTest(TestCase): 


[...] 


def test for_invalid input_renders_home_ template(self): 
response = self.client.post('/lists/new', data={'text': ''}) 
self.assertEqual(response.status_code, 200) 
self.assertTemplateUsed(response, 'home.html') 


def test validation errors_are_shown_on_home_page(self): 
response = self.client.post('/lists/new', data={'text': ''}) 
self.assertContains(response, escape(EMPTY_LIST_ERROR)) 


def test for_invalid input_passes_form to_template(self): 
response = self.client.post('/lists/new', data={'text': ''}) 
self.assertIsInstance(response.context['form'], ItemForm) 














现在 好 多 了 ， 每 个 测试 方法 只 测试 一 件 事 。 如 果 幸 运 的 话 ， 只 有 一 个 测试 会 失败 ， 而 且 会 
告诉 我 们 接 下 来 做 什么 


$ python3 manage.py test lists 
[a 


ERROR: test for_invalid input_passes_form to_template 
(lists.tests.test views.NewListTest) 


Traceback (most recent call last): 
File "/workspace/superlists/lists/tests/test views.py", line 55, in 
test_for_invalid input_passes_form to_template 
self.assertIsInstance(response.context['form'], ItemForm) 


Ea 


KeyError: 'form' 


Ran 19 tests in 0.041s 


FAILED (errors=1) 


11.3.2 ”在 视图 中 使 用 这 个 表单 


在 视图 中 使 用 这 个 表单 的 方法 如 下 : 








lists/views.py 


def new_list(request): 
form = ItemForm(data=request.POST) #@©@ 
if form.is_valid(): #@ 
List_ = List.objects.create() 
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Item.objects.create(text=request.POST[ 'text'], list=list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', {"form": form}) #@ 


@ 把 request.P0ST 中 的 数据 传 给 表单 的 构造 方法 。 
@ 使 用 form.is_valid() 判断 提交 是 否 成 功 。 








@ 如 果 提 交 失 败 ， 把 表单 对 象 传人 模板， 而 不 显示 一 个 硬 编码 的 错误 消息 字符 
视图 现在 看 起 来 更 完美 了 。 而 且 除 了 一 个 测试 之 外 ， 其 他 测试 都 能 通过 : 


self.assertContains(response, escape(EMPTY_LIST_ERROR)) 
bis 
AssertionError: False is not true : Couldn't find 'You can&#39;t have an empty 
list item' in response 


11.3.3 ”使 用 这 个 表单 在 模板 中 显示 错误 消息 
测试 失败 的 原因 是 模板 还 没 使 用 这 个 表单 显示 错误 消息 : 


lists/templates/base.html (ch111026) 


<form method="POST" action="{% block form _action %}{% endblock %}"> 
{{ form.text }} 
{% csrf_token %} 
{% if form.errors %}©O 
<div class="form-group has-error"> 
<div class="help-block">{{ form.text.errors }}</div>@ 
</div> 
{% endif %} 
</form> 


Ud 











@ form.errors 是 一 个 列表 ， 包 含 这 个 表单 中 的 所 有 错误 。 





名 form.text.errors 也 是 一 个 列表 ， 但 只 包含 text 字段 的 错误 。 


这 样 修改 之 后 对 测试 有 什么 作用 呢 ? 





FAIL: test_validation _ errors_end_up_on_lists _ page 
(lists.tests.test views.ListViewTest) 


Ex:s] 
AssertionError: False is not true : Couldn't find 'You can&#39;t have an empty 
list item' in response 


得 到 了 一 个 意料 之 外 的 失败 ， 这 次 失败 发 生 在 针对 最 后 一 个 试图 view_list 的 测试 中 。 因 
为 我 们 修改 了 错误 在 模板 中 显示 的 方式 ， 不 再 显示 手动 传人 模板 的 错误 。 





Ba 























因此 ， 还 要 修改 view_list 视图 才能 重新 回 到 可 运行 状态 。 
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11.4 在 其 他 视图 中 使 用 这 个 表单 


view_list 视图 既 可 以 处 理 GET 请 求 也 可 以 处 理 POST 请 求 。 先 测试 GET 请 求 ， 为 此 ， 可 
以 编写 一 个 新 测试 方法 : 



































lists/tests/test_ views.py 


class ListViewTest(TestCase): 


[...] 


def test displays_item form(self): 
list_ = List.objects.create() 
response = self.client.get('/lists/%d/' % (list_.id,)) 
self.assertIsInstance(response.context['form'], ItemForm) 
self.assertContains(response, 'name="text"') 

















测试 的 结果 为 : 
KeyError: 'form' 


解决 这 个 问题 最 简单 的 方法 如 下 : 





lists/views.py (ch111028) 
def view list(request, list id): 
bs] 
form = ItemForm() 
return render(request, 'list.html', { 
'list': list , "form": form, "error": error 


}) 


定义 辅助 方法 ， 简 化 测试 
接 下 来 要 在 另 一 个 视图 中 使 用 这 个 表单 的 错误 消息 ， 把 当前 针对 表单 提交 失败 的 测试 
(test_validation_errors_end_up_on_lists_page) 分 成 多 个 测试 方法 : 




















lists/tests/test views.py (ch111030) 


class ListViewTest(TestCase): 


[...] 


def post_ invalid input(self): 
list_ = List.objects.create() 
return self.client.post( 
'/lists/%d/' % (list_.id,), 
data={' text': ''} 
) 


def test for_invalid input_nothing_saved_ to _db(self): 
self.post_invalid_ input() 
self.assertEqual(Item.objects.count(), 0) 





def test for_invalid input_renders_ list template(self): 
response = self.post invalid input() 
seLf .assertEquaL(response.status_code，200) 
self.assertTemplateUsed(response, 'list.html') 


def test for_invalid input_passes_form to_template(self): 
response = self.post invalid input() 
self.assertIsInstance(response.context['form'], ItemForm) 


def test for_invalid input_shows_error_on_page(self): 
response = self.post_ invalid input() 
self.assertContains(response, escape(EMPTY_LIST_ERROR)) 


我 们 定义 了 一 个 辅助 方法 post_invalid_input， 这 样 就 不 用 在 分 拆 的 四 个 测试 中 重复 编写 
代码 了 。 








这 种 做 法 我 们 见 过 儿 次 了 。 把 视图 测试 写 在 一 个 测试 方法 中 ， 编 写 一 连 串 的 断言 检测 视图 
应 该 做 这 个 、 这 个 和 这 个 ， 然 后 应 该 返回 那个 一 一 经 常 觉得 这 么 做 更 合理 ， 但 把 单个 测试 
方法 分 解 为 多 个 方法 也 绝对 有 好 处 。 从 前 面 几 章 我 们 已 经 得 知 ， 如 果 以 后 修改 代码 时 不 小 
心 引 入 了 一 个 问题 ， 分 拆 的 测试 能 帮助 定位 真正 的 问题 所 在 。 辅 助 方法 则 是 降低 心理 障 得 
的 方式 之 一 。 


























例如 ， 现 在 测试 结果 只 有 一 个 失败 ， 而 且 我 们 知道 是 由 哪个 测试 方法 导致 的 : 


FAIL: test for_invalid input_shows_error_on_page 

(lists.tests.test views.ListViewTest) 

AssertionError: False is not true : Couldn't find 'You can&#39;t have an empty 
list item' in response 





现在 ， 试 试 能 否 使 用 ItemForm 表单 重 写 视图 。 第 一 次 尝试 : 








lists/views.py 


def view list(request, list id): 
list = List.objects.get(id=list id) 
form = ItemForm() 
if request.method == 'POST': 
form = ItemForm(data=request.POST) 
if form.is_valid(): 
Item.objects.create(text=request.POST['text'], list=list_ ) 
return redirect(list ) 
return render(request, 'list.html', {'list': list_ , "form": form}) 





[all 


重 写 后 ， 单 元 测试 通过 了 : 








Ran 23 tests in 0.086s 
OK 


再 看 功能 测试 的 结果 如 何 : 
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$ python3 manage.py test functional_tests 
Creating test database for alias 'default'... 


Ran 3 tests in 12.154s 


ER test database for alias 'default'... 

哇 哦 ! 是 不 是 有 种 如 释 重负 的 感觉 ? 刚刚 完成 了 这 个 小 型 应 用 中 的 一 项 重要 修改 一 一 那个 
输入 框 ， 以 及 它 的 nane 和 id 属性 ， 对 应 用 正常 运行 至 关 重 要 。 我 们 修改 了 七 八 个 文件 
完成 了 一 次 工作 量 很 大 的 重 构 。 如 果 没 有 测试 ， 做 这 么 复杂 的 重 构 我 一 定 会 担心 ， 其 至 有 
可 能 觉得 没 必 要 再 去 改动 可 以 使 用 的 代码 。 可 是 ， 我 们 有 一 套 完整 的 测试 组 件 ， 所 以 可 以 
深入 研究 、 整 理 代码 ， 这 些 操作 都 很 安全 ， 因 为 我 们 知道 如 果 有 错误 测试 能 发 现 。 所 以 会 
不 断 重 构 、 整 理 和 维护 代码 ， 确 保 整个 应 用 的 代码 干净 整洁 ， 运 行 起 来 毫 无 障碍 、 准 确 无 
误 ， 而 且 功 能 完善 。 


| 


) 
) 。 去 除 视 图 中 验证 水 辑 里 的 重复 









































现在 是 提交 的 绝 佳 时 刻 : 


$ git diff 
$ git commit -am"use form in all views, back to working state" 


11.5 ”使 用 表单 自 市 的 save 方 法 


我 们 还 可 以 进一步 简化 视图 。 前 面 说 过 ， 表 单 可 以 把 数据 存 入 数据库。 我 们 遇 到 的 情况 并 
不 能 直接 保存 数据 ， 因 为 需要 知道 把 待 办 事项 保存 到 哪个 清单 中 ， 不 过 解决 起 来 也 不 难 。 


下 














一 1 





























一 如 既往 ， 先 编写 调试 。 为 了 查 明 遇 到 的 问题 ， 先 看 一 下 如 果 直 接 调用 form.save() 会 发 
生 什么 : 








lists/tests/test forms.py (ch111032) 


def test form_ save_handles_saving to a list(self): 
form = ItemForm(data={'text': 'do me'}) 
new_item = form.save() 





Django 报错 了 ， 因 为 待 办 事项 必须 隶属 于 某 个 清单 ; 
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django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 


这 个 问题 的 解决 办 法 是 告诉 表单 的 save 方法 ， 应 该 把 待 办 事项 保存 到 哪个 清单 中 : 








lists/tests/test forms.py 


from lists.models import Item, List 


[ss 


def test_form_save_handLes_saving_to_a_List(seLf) : 
list = List.objects.create() 
form = ItemForm(data={'text': 'do me'}) 
new_item = form.save(for_list=list ) 
self.assertEqual(new_item, Item.objects.first()) 
self.assertEqual(new_item.text, 'do me') 
self.assertEqual(new_item.list, list ) 


然后 ， 要 保证 待 办 事项 能 顺利 存 和 数据库 ， 而 且 各 个 属性 的 值 都 正确 : 








TypeError: save() got an Unexpected keyword argument 'for_List' 
可 以 定制 save 方法 ， 实 现 方式 如 下 ; 


lists/forms.py (ch111034) 


def save(self, for_list): 
self.instance.list = for_list 
return super().save() 


表单 的 .instance 属性 是 将 要 修改 或 创建 的 数据 库 对 象 。 我 也 是 在 撰写 本 章 时 才 知 道 这 种 
用 法 。 此 外 还 有 很 多 方法 ， 例 如 自己 手动 创建 数据 库 对 象 ， 或 者 调用 savel) 方法 时 指定 参 
数 commit=False， 但 我 觉得 使 用 .instance 属性 最 简洁 。 下 一 章 还 会 介绍 一 种 方法 ， 让 表 
单 知道 它 应 用 于 哪个 清单 。 





























Ran 24 tests in 0.086s 
OK 


最 后 ， 要 重 构 视 








| 


。 先 重 构 new_list. 











lists/views.py 


def new_list(request): 

form = ItemForm(data=request.POST) 

if form.is valid(): 
list = List.objects.create() 
form.save(for_list=list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', {"form": form}) 


然后 运行 测试 ， 确 保 都 能 通过 : 
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Ran 24 tests in 0.086s 
OK 


接着 重 构 view_list: 





lists/views.py 


def view list(request, list id): 
list = List.objects.get(id=list id) 
form = ItemForm() 
if request.method == 'POST': 
form = ItemForm(data=request.POST) 
if form.is_valid(): 
form.save(for_list=list ) 
return redirect(list ) 
return render(request, 'list.html', {'list': list_ , "form": form}) 


修改 之 后 ， 单 元 测试 仍 能 全 部 通过 : 


Ran 24 tests in 0.111s 





OK 
功能 测试 也 能 通过 : 
Ran 3 tests in 14.367s 


OK 





太 棒 了 ! 现在 这 两 个 视图 更 像 是 “正常 的 ”Django 视图 了 : 从 用 户 的 请 求 中 读 取 数 据 ， 结 
合 一 些 定制 的 逻辑 或 URL 中 的 信息 (tist_id)， 然 后 把 数据 传 入 表单 进行 验证 ， 如 果 通 过 
验证 就 保存 数据 ， 最 后 重 定 向 或 者 渲染 模板 。 








表单 和 验证 在 Django 以 及 常规 的 Web 编程 中 都 很 重要 ， 下 一 章 我 们 要 看 一 下 能 否 编写 稍 
微 复杂 的 表单 。 








小 贴 士 
。 简化 视图 
如 果 发 现 视图 很 复杂 ， 要 编写 很 多 测试 ， 这 时 候 就 应 该 考虑 是 否 能 把 逻辑 移 到 其 他 
地 方 。 可 以 移 到 表单 中 ， 就 像 本 章 中 的 做 法 一 样 。 或 者 可 以 移 到 模型 类 的 自 定义 方 
法 中 。 如 果 应 用 本 身 就 很 复杂 ， 可 以 把 核心 业务 逻辑 移 到 Django 专属 的 文件 之 外 ， 
编写 单独 的 类 和 函数 。 


。 一 个 测试 只 测试 一 件 事 
如 果 一 个 测试 中 不 止 一 个 断言 ， 你 就 要 怀疑 这 么 写 是 否 合理 。 有 时 断言 之 间 联 系 紧 
密 ， 可 以 放 在 一 起 。 不 过 第 一 次 编写 测试 时 往往 都 会 测试 很 多 表现 ， 其 实 应 该 把 它 
们 分 成 多 个 测试 。 辅 助 函 数 有 助 于 简化 拆 分 后 的 测试 。 
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第 12 章 





本 章 介 绍 表 单 的 一 些 高 级 用 法 。 我 们 已 经 帮助 用 户 避 免 输 入 空 待 办 事项 ， 要 避免 户 输入 重 


高 级 表单 








复 的 待 办 事项 。 


本 章 介绍 Django 表单 验证 的 更 为 复杂 细节 。 如 果 你 已 经 完全 了 解 定制 Django 表单 的 知识 ， 














可 以 把 本 章 作为 选读 材料 。 如 果 你 还 在 学 习 Django， 本 章 有 些 重要 的 知识 值得 学 习 。 如 有 果 
你 想 跳 过 本 章 也 可 以 ， 不 过 一 定 要 快速 阅读 关于 开发 者 犯错 的 旁 注 和 本 章 末 尾 对 视图 测试 
的 总 结 。 


12. 





1 ”针对 重复 待 办 事项 的 功能 测试 














在 ItemValidationTest 类 中 再 添加 一 个 测试 方法 : 





functional tests/test list item_validation.py (ch121001) 





def test_cannot_add_duplicate items(self): 


# 伊 迪 丝 访问 首页 ,新 建 一 个 清单 
self.browser.get(self.server_url) 

self.get item input box().send_keys('Buy wellies\n') 
self.check_for_row_in_ list table('1: Buy wellies') 


# 她 不 小 心 输入 了 一 个 重复 的 待 办 事项 
self.get_ item input_box().send_keys('Buy wellies\n') 








# 她 看 到 一 条 有 帮助 的 错误 消息 

self.check_for_row_in_list table('1: Buy weLLies ' ) 

error = self.browser.find element_by_css_selector('.has-error') 
seLf.assertEquaL(error .text，"You've already got this in your list") 
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为 什么 编写 两 个 测试 方法 ， 而 不 直接 在 原来 的 基础 上 扩展 ， 或 者 新 建 一 个 文件 和 类 ? 要 自 
己 判 断 该 怎么 做 。 Sd 都 和 同一 个 输入 字段 的 验证 有 关 ， 所 以 放 
在 同一 个 文件 中 没 问题 。 另 一 方面 ， 这 两 种 方法 在 逻辑 上 互相 独立 ， 所 以 将 它们 设 为 不 同 
的 两 种 不 同 的 方法 是 可 行 的 : 























$ python3 manage.py test functional_tests.test_list item _validation 


[...] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to locate 
element: {"method":"css selector","selector":".has-error"}' ; Stacktrace: 


Ran 2 tests in 9.613s 





好 的 ， 这 两 个 测试 中 的 第 一 个 现在 可 以 通过 。 你 可 能 会 癌 :“ 有 没有 办 法 只 运行 那个 失败 
的 测试 ? ”确实 有 : 


$ python3 manage.py test functional_tests.\ 

test_list_item validation.ItemValidationTest.test_cannot_add_duplicate_items 
[...] 

selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"css selector","selector":".has-error"}' ; Stacktrace: 


12.1.1 在 模型 层 禁 止 重 复 


这 是 我 们 真正 要 做 的 事情 。 编 写 一 个 新 测试 ， 检 查 同一 个 清单 中 有 重复 的 待 办 事项 时 是 否 
抛 出 异常 : 











lists/tests/test _ models.py (ch091028) 


def test duplicate items are_ invalid(self): 
list = List.objects.create() 
Item.objects.create(list=list_ , text='bla') 
with self.assertRaises(ValidationError): 
item = Item(list=list_ , text='bla') 
item.full_clean() 





此 外 ， 还 要 再 添加 一 个 测试 ， 确 保 完整 性 约束 不 要 做 过 头 了 : 


lists/tests/test models.py (ch091029) 


def test CAN_save_same item to different lists(self): 
list1 = List.objects.create() 
list2 = List.objects.create() 
Item.objects.create(list=list1, text='bla') 
item = Item(list=list2, text='bla') 
item.full_clean() # 不 该 抛 出 异常 





我 总 喜欢 在 检查 某 项 操作 不 该 抛 出 异常 的 测试 中 加 入 一 些 注释 ， 要 不 然 很 难看 出 在 测试 什么 。 





AssertionError: ValidationError not raised 


如 果 想 故意 犯错 ， 可 以 这 么 做 : 
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革 12 晶 


lists/models.py (ch091030) 


class Item(models.Model): 
text = models.TextField(default='', unique=True) 
list = models.ForeignKey(List, default=None) 


这 么 做 可 以 确认 第 二 个 测试 确实 能 检测 到 这 个 问题 


Traceback (most recent call last): 
File "/workspace/superlists/lists/tests/test models.py", line 62, in 
test_CAN_save_same item to different_ lists 
item.full_clean() # 不 该 抛 出 异常 
[二 洒 
django.core.exceptions.ValidationError: {'text': ['Item with this Text already 
exists.']} 








何 时 测试 开发 者 犯 下 的 错误 
测试 时 要 判断 何 时 应 该 编写 测试 确认 我 们 没有 犯错 。 一 般 而 言 ， 做 决定 时 要 谨慎 。 


这 里 ， 编 写 测试 确认 无 法 把 重复 的 待 办 事项 存 入 同一 个 清单 。 目 前 ， 让 这 个 测试 通过 
最 简单 的 方法 ( 即 编写 的 代码 量 最 少 ) 是 ， 让 表单 无 法 保存 任何 重复 的 待 办 事项 。 此 
时 就 要 编写 另 一 个 测试 ， 因 为 我 们 编写 的 代码 可 能 有 错 。 


但 是 ， 不 可 能 编写 测试 检查 所 有 可 能 出 错 的 方式 。 如 果 有 一 个 函数 计算 两 数 之 和 ， 可 
以 编写 一 些 测 试 : 


assert adder(1，1) == 2 
assert adder(2, 1) == 3 


但 不 应 该 认为 实现 这 个 函数 时 故意 编写 了 有 违 常理 的 代码 : 


def adder(a, b): 
# 不 可 能 这 么 写 ! 
if a == 3: 
return 666 
else: 
returna+b 


判断 时 你 要 相信 自己 不 会 故意 犯错 ， 只 会 不 小 心 犯错 。 











模型 和 ModeLForm 一 样 ， 也 能 使 用 class Meta。 在 Meta 类 中 可 以 实现 一 个 约束 ， 要 求 清单 























中 的 待 办 事项 必须 是 唯一 的 。 也 就 是 说 ，text 和 List 的 组 合 必 须 是 唯一 的 : 








lists/models.py (ch091031) 


class Item(models.Model): 
text = models.TextField(default='') 
list = models.ForeignKey(List, default=None) 


class Meta: 
unique_ together = ('list', 'text') 
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此 时 ， 你 可 能 想 快 速 浏 览 一 遍 Django 文档 中 对 模型 


< 





曙 性 Meta 的 说 明 (https://docs.djangoproject. 





com/en/1.7/ref/models/options/) 。 


12.1.2” 题 外 话 : 查询 集合 排序 和 字符 串 表 示 形 式 


运行 测试 ， 会 看 到 一 个 意料 之 外 的 失败 : 


FAIL: test_ saving_and_retrieving items 
(lists.tests.test models.ListAndItemModelsTest) 
Traceback (most recent call last): 

File "/workspace/superlists/lists/tests/test models.py", line 31, in 
test_saving_and_retrieving_ items 

self.assertEqual(first saved item.text, 'The first (ever) list item') 

AssertionError: 'Item the second' != 'The first (ever) list item' 
- Item the second 


[...] 








根据 所 用 系统 和 SQLite 版 本 的 不 同 ， 你 可 能 看 到 不 到 这 个 错误 。 如 果 设 看 到 
就 直接 阅读 下 一 节 ， 代 码 和 测试 本 身 也 很 有 趣 。 








失败 消息 有 点 儿 隐 座 。 输 出 一 些 信息 ， 以 便 调 试 : 


bY 


lists/tests/test_models.py 
first_saved item = saved_items[0] 
print(first_saved_ item.text) 
second_saved item = saved items[1] 
print(second_saved_item. text) 
self.assertEqual(first saved item.text, 'The first (ever) list item') 


后 ， 看 到 的 测试 结果 如 下 : 


a Item the second 
The first (ever) list item 


看 样子 唯一 性 约束 干扰 了 查询 (例如 Item.objects.all()) 的 默认 排序 。 虽 然 现在 仍 有 测 
试 失败 ， 但 最 好 添加 一 个 新 测试 明确 测试 排序 : 





lists/tests/test_models.py (ch091032) 


def test list ordering(self): 
list1 = List.objects.create() 
item1 = Item.objects.create(list=list1, text='i1') 
item2 = Item.objects.create(list=list1, text='item 2') 
item3 = Item.objects.create(list=list1, text='3') 





self.assertEqual(l 
Item.objects.all(), 
[item1, item2, item3] 


) 
测试 的 结果 多 了 一 个 失败 ， 而 且 也 不 易 读 : 


AssertionError: [<Item: Item object>, <Item: Item object>, <Item: Item object>] 


!= [<Item: Item object>, <Item: Item object>, <Item: Item object>] 


我 们 的 对 象 需要 一 个 更 好 的 字符 串 表 示 形 式 。 下 面 再 添加 一 个 单元 测试 











如 果 已 经 有 测试 失败 ， a te 通常 都 要 三 思 而 后 行 ， 
因为 这 么 做 会 让 测试 的 输出 变 得 更 复杂 ， 而 且 往 往 你 都 会 担心 :“ 还 能 回 到 
正常 运行 的 状态 吗 ? ”这 里 ， Rs ， 所 以 我 不 担忧 。 

















lists/tests/test models.py (ch121008) 
def test_string_representation(self): 
item = Item(text='some text') 


self.assertEqual(str(item), 'some text') 


测试 的 结果 为 : 


AssertionError: 'Item object' != 'some text' 


连同 另外 两 个 失败 ， 现 在 开始 一 并 解决 : 








lists/models.py (ch091034) 
class Item(models.Model): 


[...] 


def _ str__(self): 
return self.text 





在 Python 2.x 的 Django 版 本 中 ,字符 串 表 示 形 式 使 用 __unicode__ 方法 定制 。 
和 很 多 字符 串 处 理 方式 一 样 ，Python 3 对 此 做 了 简化 。 参 见 文档 (https:// 
docs.djangoproject.com/en/1.7/topics/python3/#str-and-unicode-methods)。 











现在 只 剩 两 个 失败 测试 了 ， 而 且 排序 测试 的 失败 消息 更 易 读 了 : 


AssertionError: [<Item: 3>, <Item: i1> 


， <Item: item 2>] != [<Item: i1i>, <Item: 
item 2>, <Item: 3>] 


可 以 在 class Meta 中 解决 这 个 问题 
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lists/models.py (ch091035) 


class Meta: 
ordering = ('id',) 
unique together = ('list', 'text') 


这 么 做 有 用 吗 ? 

AssertionError: [<Item: i1>, <Item: item 2>, <Item: 3>] != [<Item: i1>, <Itenm: 

item 2>, <Item: 3>] 
听 ， 确 实 有 用 ， 从 测试 结果 中 可 以 看 到 ， 顺 序 是 一 样 的， 只 不 过 测试 没 分 清 。 其 实 我 一 直 
会 遇 到 这 个 问题 ， 因 为 Django 中 的 查询 集合 不 能 和 列表 正确 比较 。 可 以 在 测试 中 把 查询 
集合 转换 成 列表 ' 解决 这 个 问题 














lists/tests/test models.py (ch091036) 


self.assertEqual( 
list(Item.objects.all()), 
[item1, item2, item3] 


) 
这 样 就 可 以 了 ， 整 个 测试 组 件 都 能 通过 


OK 


12.1.3 重 写 旧 模 型 测试 

虽然 元 长 的 模型 测试 无 意 间 帮 有 我 们 发 现 了 一 个 问题 ， 但 现在 要 重 写 模型 测试 。 重 写 的 过 
程 中 我 会 讲 得 很 详细 ， 因 为 借 此 机 会 要 介绍 Django ORM。 既 然 我 们 已 经 编写 了 专门 测试 
排序 的 测试 ， 现 在 就 可 以 使 用 一 些 较 短 的 测试 达到 相同 的 覆盖 度 。 删 除 test_saving_and_ 


retrieving_items， 换 成 : 

















lists/tests/test models.py (ch121010) 
class ListAndItemModelsTest(TestCase): 


def test default text(self): 
item = Item() 
self.assertEqual(item.text, '') 


def test item is related to list(self): 
list_ = List.objects.create() 
item = Item() 
item.list = list_ 
item.save() 
self.assertIn(item, list_.item set.all()) 


[...] 











证 1: 也 可 以 考虑 使 用 unittest 中 的 assertSequenceEquaL， 以 及 Django 测试 工具 中 的 assertQuerysetEqual。 
不 过 我 承认 ， 之 前 我 并 没 搞 清楚 怎么 使 用 assertQuerysetEquat。 























这 么 改 绰绰有余 。 初 始 化 一 个 全 新 的 模型 对 象 ， 检 查 属 性 的 默认 值 ， 这 么 做 足以 确认 
models.py 中 是 否 正确 设 定 了 一 些 字段 。test_item is_related_to_list 其 实 是 双重 保险 ， 
确认 外 键 关联 是 否 正常 。 

借 此 机 会 ， 还 要 把 这 个 文件 中 的 内 容 分 成 专门 针对 Item 和 List 的 测试 (后 者 只 有 一 个 测 
试 方法 ， 即 test_get_absoLute_urL) : 


























lists/tests/test models.py (ch121011) 
class ItemModelTest(TestCase): 


def test default text(self): 
[...] 
class ListModelTest(TestCase): 


def test get absolute url(self): 
[...] 


修改 之 后 代码 更 整洁 。 测 试 结果 如 下 : 
$ python3 manage.py test lists 
Ls] 
Ran 29 tests in 0.092s 


OK 


12.1.4 ”保存 时 确实 会 显示 完整 性 错误 
在 继续 之 前 还 有 一 个 题 外 话 要 说 。 我 在 第 10 章 提 到 过 ， 保 存 数据 时 会 出 现 一 些 数 据 完 整 
性 错误 ， 还 记得 吗 ? 是 否 出 现 完 整 性 错误 完全 取决 于 完整 性 约束 是 否 由 数据 库 执 行 。 


执行 makemigrations 命令 试 试 ， 你 会 看 到 ，Django 除了 把 unique_together 作为 应 用 层 约 
东 之 外 ， 还 想 把 它 加 到 数据 库 中 ; 











$ python3 manage.py makemigrations 
Migrations for 'lists': 
0005_auto_20140414_2038.py: 
- Alter unique together for item (1 constraints) 


现在 ， 修 改 检查 重复 待 办 事项 的 测试 ， 把 .full_clean 改 成 .save: 





lists/tests/test models.py 


def test duplicate items are invalid(self): 
list_ = List.objects.create() 
Item.objects.create(list=list , text='bla') 
with self.assertRaises(ValidationError): 
item = Item(list=list_ , text='bla') 
# item.full_clean() 
item.save() 
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测试 的 结果 为 : 


ERROR: test_dupLicate_items_are_invaLid (lists.tests.test models.ItemModelTest) 
[...] 

return Database.Cursor .execute(self, query, params) 
sqlite3.IntegrityError: UNIQUE constraint failed: lists itenm.list id, 
lists_item.text 
[ss 
django.db.utils.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists_ item.text 


可 以 看 出 ， 错 误 是 由 SQLite 导致 的 ， 而 且 错 误 类 型 也 和 我 们 期 望 的 不 一 样 ， 我 们 想得到 的 


是 ValidationError， 实 际 却 是 IntegrityError。 





把 改动 改 回去 ， 让 调试 全 部 通过 : 





$ python3 manage.py test lists 
| Wy 

Ran 29 tests in 0.092s 

OK 





然后 提交 对 模型 层 的 修改 : 





T 


$ git status # 会 看 到 改动 了 测试 和 模型 ,还 有 一 个 新 迁移 文件 
# 我 们 给 新 迁移 文件 起 一 个 更 好 的 名 字 

$ mv lists/migrations/0005_auto* lists/migrations/0005_list_item_unique_together.py 
$ git add lists 

$ git diff --staged 

$ git commit -am "Implement duplicate item validation at model layer" 


12.2 ”在 视图 层 试验 待 办 事项 重复 验证 


运行 


运行 功能 测试 时 浏览 器 窗口 一 闪 而 过 , 你 可 能 没 看 到 网 站 现在 处 于 500 状态 之 中 。? 简单 的 


功能 测试 ， 看 看 现在 我 们 进展 到 哪里 了 : 


selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"id list table"}' ; Stacktrace: 





修改 视图 层 单元 测试 应 该 能 解决 这 个 问题 : 








lists/tests/test views.py (ch121014) 


class ListViewTest(TestCase): 


车 


def test for_invalid input_shows_error_on_page(seLf) : 


[...] 


def test_ duplicate item validation errors_end up_on_lists_ page(self): 


























注 2; 显示 一 个 服务 器 错误 ， 响 应 码 为 500。 你 要 明白 这 些 术语 的 意思 。 
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List1 = List.objects.create() 
item1 = Item.objects.create(list=list1, text='textey') 
response = self.client.post( 

'/lists/%d/' % (list1.id,), 

data={' text': 'textey'} 


expected_error = escape("You've already got this in your list") 
self.assertContains(response, expected error) 
self.assertTemplateUsed(response, 'list.html') 
self.assertEqual(Item.objects.all().count(), 1) 


测试 结果 为 : 


django.db.utils.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists_item.text 




















我 们 不 想 让 测试 出 现 完整 性 错误 ! 理想 情况 下 ,希望 在 尝试 保存 数据 之 前 调用 is_valid 
时 ， 已 经 注意 到 有 重复 。 不 过 ， 在 此 之 前 ， 表 单 必须 知道 待 办 事项 属于 哪个 清单 。 


现在 暂时 为 这 个 测试 加 上 @skip 修饰 器 














lists/tests/test views.py (ch121015) 


from unittest import skip 


[sted 


@skip 
def test_ duplicate item validation errors_end_up_on_lists page(self): 


12.3 ”处 理 唯 一 性 验证 的 复杂 表单 


新 建 清 单 的 表单 只 需 知道 一 件 事 ， 即 新 待 办 事项 的 文本 。 验 证 清单 中 的 代办 事项 是 否 唯 
， 表 单 需要 知道 使 用 哪个 清单 以 及 待 办 事项 的 文本 。 就 像 前 面 我 们 在 ItemForm 类 中 定义 
save 方法 一 样 ， 这 一 次 要 重 定义 表单 的 构造 方法 ， 让 它 知 道 待 办 事项 属于 哪个 清单 。 


复制 前 一 个 表单 的 测试 ， 稍 微 做 些 修改 : 
























































lists/tests/test forms.py (ch121016) 
from lists.forms import ( 
DUPLICATE_ITEM_ ERROR, EMPTY_LIST_ERROR, 
ExistingListItemForm, ItemForm 
) 
[i] 


class ExistingListItemFormTest(TestCase): 


def test form renders_item text input(self): 
list = List.objects.create() 
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def 


def 


form = ExistingListItemForm(for_list=list ) 
self.assertIn('placeholder="Enter a to-do item"', form.as_p()) 


test_form validation for_blank_items(self): 

List_ = List.objects.create() 

form = ExistingListItemForm(for_list=list_ , data={'text': ''}) 
self.assertFalse(form.is_valid()) 
self.assertEqual(form.errors['text'], [EMPTY_LIST_ERROR]) 


test_form validation for_duplicate items(self): 

list_ = List.objects.create() 

Item.objects.create(list=list , text='no twins!') 

form = ExistingListItemForm(for_list=list_, data={'text': "no twins!'}) 
self.assertFalse(form.is_valid()) 

self.assertEqual(form.errors['text'], [DUPLICATE_ITEM_ ERROR]) 


要 历经 几 次 TDD 循环 (我 不 会 写 出 全 部 过 程 ， 但 我 相信 你 会 做 完 的 ， 对 吗 ? 记 住 ， 测 试 山 


羊 能 


def 

















到 一 切 ) ， 最 后 才能 得 到 一 个 自 定义 的 构造 方法 。 这 个 构造 方法 会 名 略 for_List 参数 : 





lists/forms.py (chO91071) 


DUPLICATE_ITEM_ ERROR = "You've already got this in your list" 
a 
class ExistingListItemForm(forms.models.ModelForm): 
_init (self, for_list, *args, **kwargs): 


super()._ init (*args, **kwargs) 


测试 的 结果 为 : 


ValueError: ModeLForm has no model class specified. 





现在 ， 让 这 个 表单 继承 现 有 的 表单 ， 看 测试 能 不 能 通过 : 


def 


lists/forms.py (ch091072) 


class ExistingListItemForm(ItemForm): 


__init (self, for_list, *args, **kwargs): 
super()._ init (*args, **kwargs) 


现在 只 剩 一 个 失败 测试 了 : 














FAIL: test_ form validation for_duplicate items 
(lists.tests.test forms.ExistingListItemFormTest) 


self.assertFalse(form.is_valid()) 


AssertionError: True is not false 


下 面 这 一 步 需 要 了 解 一 点 Django 内 部 运作 机 制 ， 你 可 以 阅读 Django 文档 中 对 模型 验证 
(https://docs.djangoproject.com/en/1.7/ref/models/instances/#validating-objects) 和 表单 验证 
(https://docs.djangoproject.com/en/1.7/ref/forms/validation/) 的 介绍 了 解 。 





Django 在 表单 和 模型 中 都 会 调用 vattdate_unique 方法 ， 借 助 instance 属性 在 表单 的 





vaLidate_unique 方法 中 调用 模型 的 validate_unique 方法 : 


lists/forms.py 
from django.core.exceptions import ValidationError 


本 
class ExistingListItemForm(ItemForm): 


def _ init (self, for_list, *args, **kwargs): 
super()._ init (*args, **kwargs) 
self.instance.list = for_list 


def validate unique(self): 
try: 
self.instance.validate_unique() 
except ValidationError as e: 
e.error_dict = {'text': [DUPLICATE_ITEM_ERROR]} 
self._update_errors(e) 





这 段 代码 用 到 了 一 点 Django 魔法 ， 先 获取 验证 错误 ， 修 改 错误 消息 之 后 再 把 错误 传 回 表 
单 。 任 务 完成 ， 做 个 简单 的 提交 : 








$ git diff 
$ git commit -a 


12.4 ”在 清单 视图 中 使 用 ExistingListItemForm 
现在 看 一 下 能 否 在 视图 中 使 用 这 个 表单 。 























要 删 掉 测试 方法 的 @skip 修饰 器 ， 与 


于 


同时 还 要 使 用 前 一 节 创 建 的 常量 清理 测试 。 














lists/tests/test_ views.py (ch121049) 


from lists.forms import ( 
DUPLICATE_ITEM_ ERROR, EMPTY_LIST_ERROR, 
ExistingListItemForm, ItemForm, 


) 
[...] 


def test_ duplicate item validation errors_end_ up_on_lists_ page(self): 


[as 
expected_error = escape(DUPLICATE_ITEM_ ERROR) 


修改 之 后 完整 性 错误 又 出 现 了 : 





django.db.utils.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists_item.text 


解决 方法 是 使 用 前 一 市 定义 的 表单 类 。 在 此 之 前 ， 先 找到 检查 表单 类 的 测试 ， 然 后 按照 下 
面 的 方式 修改 : 
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lists/tests/test views.py (ch121050) 


class ListViewTest(TestCase): 


[is] 


def test displays_item form(self): 
List_ = List.objects.create() 
response = self.client.get('/lists/%d/' % (list_.id,)) 
self.assertIsInstance(response.context['form'], ExistingListItemForm) 
self.assertContains(response, 'name="text"') 


[...] 


def test for_invalid input_passes_form to_template(self): 
response = self.post invalid input() 
self.assertIsInstance(response.context['form'], ExistingListItemForm) 





修改 之 后 测试 的 结果 为 : 


AssertionError: <Lists.forms.ItemForm object at 0x7f767e4b7f90> is not an 
instance of <class 'lists.forms.ExistingListItemForm'> 


那么 就 可 以 修改 视图 了 : 


lists/views.py (ch1210571) 


from Lists.forms import ExistingListItemForm, ItemForm 
[...] 
def view list(request, list id): 
list = List.objects.get(id=list id) 
form = ExistingListItemForm(for_list=list ) 
if request.method == 'POST': 
form = ExistingListIitemForm(for_list=list_, data=request.POST) 
if form.is_valid(): 
form.save() 


[...] 
问题 几乎 都 解决 了 ， 但 又 出 现 了 一 个 意料 之 外 的 失败 : 





TypeError: save() missing 1 required positional argument: 'for_list' 


不 再 需要 使 用 父 类 ItemForm 中 自 定义 的 save 方法 。 为 此 ， 先 编写 一 个 单元 测试 : 





lists/tests/test forms.py (ch121053) 


def test form save(self): 
list = List.objects.create() 
form = ExistingListItemForm(for_list=list_ , data={'text': 'hi'}) 
new_item = form.save() 
self.assertEqual(new_item, Item.objects.all()[0]) 





可 以 让 表单 调用 祖父 类 中 的 save 方法 : 





lists/forms.py (ch12105 


def save(self): 
return forms.models.ModelForm.save(self) 


个 人 观点 : 这 里 可 以 使 用 super， 但 是 有 参数 时 我 选择 不 用 ， 例 如 获取 祖父 
类 中 的 方法 。 我 觉得 使 用 Python 3 的 super() 方法 获取 直接 父 类 很 棒 ， 但 其 
他 用 途 太 容易 出 错 ， 而 且 写 出 的 代码 也 不 好 看 。 你 的 观点 可 能 与 我 不 同 。 








人 





高 定 ! 所 有 单元 测试 都 能 通过 
$ python3 manage.py test lists 
0 tests in 0.082s 
OK 


针对 验证 的 功能 测试 也 能 通过 


$ python3 manage.py test functional._tests.test_list item validation 
Creating test database for alias 'default'... 


Ran 2 tests in 12.048s 


OK 
Destroying test database for alias 'default'... 





检查 的 最 后 一 3 运行 能 测试 


$ python3 manage.py test functionaL_tests 
Creating test database for alias 'default'... 


Ran 4 tests in 19.048s 


OK 
Destroying test database for alias 'default'... 





太 棒 了 ! 最 后 还 要 提交 ， 然 后 总 结 这 几 章 我 们 学 到 的 视图 测试 知识 。 


幼 





如 何 测试 视图 
测试 代码 摘录 ， 显 示 所 有 视图 测试 方法 和 断言 
class ListViewTest(TestCase): 
def test uses_ list template(self): 


response = self.client.get('/lists/%d/' % (list_.id,)) #0 
self.assertTemplateUsed(response, 'list.html') #@ 
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@ 


O00 


田 @ 





def 


def 


def 


def 


def 


def 


def 


def 


def 


def 


test_passes_correct list to template(self): 
self.assertEqual(response.context['list'], correct_ list) #@ 

test_ displays_item form(self): 
self.assertIsInstance(response.context['form'], ExistingListItemForm) #@ 
self.assertContains(response, 'name="text"') 

test_displays_only_items for_that_list(self): 
self.assertContains(response, 'itemey 1') #@ 
self.assertContains(response, 'itemey 2') #@ 
self.assertNotContains(response, 'other list item 1') #@ 
test_can_save_a_POST_request_to_an_existing_list(self): 
self.assertEqual(Item.objects.count(), 1) #@ 
self.assertEqual(new_item.text, 'A new item for an existing list') #© 
test_POST_redirects to_ list view(self): 

self.assertRedirects(response, '/lists/%d/' % (correct list.id,)) #@ 
test_for_invalid input_nothing_saved_to db(self): 
self.assertEqual(Item.objects.count(), 0) #0®D 

test_for_invalid input_renders_list template(self): 
self.assertEqual(response.status_code, 200) 
self.assertTemplateUsed(response, 'list.html’') #® 

test_for_invalid input_passes_form to_ template(self): 
self.assertIsInstance(response.context['form'], ExistingListItemForm) #® 
test_for_invalid input_shows_error_on_page(self): 
self.assertContains(response, escape(EMPTY_LIST_ERROR)) #® 

test_ duplicate item validation_ errors_end up_on_lists page(self): 
self.assertContains(response, expected error) 
self.assertTemplateUsed(response, 'list.html') 
self.assertEqual(Item.objects.all().count(), 1) 


使 用 Django 测试 客户 端 。 

检查 使 用 的 模板 。 然 后 在 模板 的 上 下 文中 检查 各 个 待 办 事项 。 

检查 每 个 对 象 都 是 希望 得 到 的 ， 或 者 查询 集合 中 包含 正确 的 待 办 事项 。 
检查 表单 使 用 正确 的 类 。 


检查 模板 逻辑 : 每 个 for 和 if 语句 都 要 做 最 简单 的 测试 。 


@9@@@ 对 于 处 理 POST 请 求 的 视图 ， 确 保有 效 和 无 效 两 种 情况 都 要 测试 。 


健全 性 检查 ， 检 查 是 否 泻 染 指定 的 表单 ， 而 且 是 否 显示 错误 消息 。 


为 什么 要 测试 这 么 多 ?请 阅读 附录 B。 使 用 基于 类 的 视图 重 构 时 ， 这 些 测试 能 保证 视 
图 仍然 可 以 正常 运行 。 





接 下 来 要 尝 





试 使 用 一 些 客户 端 代 码 让 数据 验证 更 友好 。 我 想 你 知道 这 是 什么 意思 。 
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试探 JavaScript 


“如 果 上 壳 想 让 我 们 享受 生活 ， 
就 不 会 把 他 无 尽 的 痛苦 当 作 珍贵 的 礼物 赠与 我 们 。” 


一 一 John Calvin! 


虽然 前 面 实现 的 验证 逻辑 很 好 ， 但 当 用 户 开始 修正 问题 时 ， 让 错误 消息 消失 不 是 更 好 吗 ? 











为 了 达到 这 个 效果 ， 需 要 使 用 少量 的 JavaScript。 





每 天 使 用 Python 这 种 充满 乐趣 的 语言 编程 完全 把 我 们 完 坏 了 。JavaScript 是 给 我 们 的 惩罚 。 





接 下 来 要 十 分 谨慎 地 试探 如 何 使 用 JavaScript。 


粹 》(JavaScript: The Good Parts)， 现 在 就 买 一 本 





13.1 ”从 功能 测试 开始 


在 ItemValidationTest 类 中 添加 一 个 新 的 功能 测试 : 














巴 ! 这 本 


我 假设 你 知道 基本 的 JavaScript 名 法。 如果 你 还 没 读 过 《JavaScript 语言 精 


局 并 不 厚 。 


functional tests/test list item_validation.py (ch141001) 





def test_ error_messages_are_cleared_on_input(self): 


# 伊 迪 丝 新 建 一 个 清单 ,但 方法 不 当 , 所 以 出 现 了 一 个 验证 错误 





self.browser.get(self.server_url) 























注 1: Calvin and the Chipmunk(http://onemillionpoints.blogspot.co.uk/2008/08/calvin-and-chipmunks.html) 中 的 角色 。 
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self.get item input_ box().send_ keys('\n') 
error = self.browser.find element by_css_selector('.has-error') 
self.assertTrue(error.is_ displayed()) #0 





# 为 了 消除 错误 ,她 开始 在 输入 框 中 输入 内 容 
self.get item input_ box().send_ keys('a') 





# 看 到 错误 消息 消失 了 ,她 很 高 兴 
error = self.browser.find element by_css_selector('.has-error') 
self.assertFalse(error.is displayed()) # 

















O@ @ is_displayed() 可 检查 元 素 是 否 可 见 。 不 能 只 靠 检查 元 素 是 否 存在 于 DOM 中 去 判断 ， 
因为 现在 要 开始 隐藏 元 素 了 。 


无 疑 ， 这 个 测试 会 失败 。 但 在 继续 之 前 ， 要 应 用 “ 事 不 过 三 ,三 则 重 构 ”原则 ， 
i CSS 查找 错误 消息 元 素 。 把 这 个 操作 移 到 一 个 辅助 函数 中 : 











functional tests/test list item_validation.py (ch141002) 





def get_ error_element(self): 
return self.browser.find element by_css_selector('.has-error') 


我 喜欢 把 辅助 函数 放 在 使 用 它们 的 功能 测试 类 中 ， 仅 当 辅 助 函 数 需 要 在 别处 
使 用 时 才 放 在 基 类 中 ， 以 防止 基 类 太 腔 有 种 。 这 就 是 YAGNI 原则 。 

















然后 ， 在 test_list_item_validation.py 中 做 五 次 赫 换 ， 例 如 : 


functional tests/test list item validation.py (ch141003) 








# 看 到 错误 消息 消失 了 ,她 很 高 兴 
error = self.get error_element() 
self.assertFalse(error.is_ displayed()) 











得 到 了 一 个 预期 错误 : 


$ python3 manage.py test functional_tests.test_ list item _validation 


[...] 
self.assertFalse(error.is displayed()) 
AssertionError: True is not false 


可 以 提交 这 些 代码 ， 作 为 对 功能 测试 的 首次 改动 。 


13.2 ”安装 一 个 基本 的 JavaScript 测 试 运行 程序 


在 Python 和 Django 领域 中 选择 测试 工具 非常 简单 。 标 准 库 中 的 unittest 模块 完全 够 用 
了 ， 而 且 Django 测试 运行 程序 也 是 一 个 不 错 的 默认 选择 。 除 此 之 外 ， 还 有 一 些 替代 工 
具 nose (http://nose.readthedocs.org/) 很 受 欢迎 ， 我 个 人 对 pytest (http://pytest.org/) 的 











214 | 第 13 章 


印象 比较 深刻 。 不 过 默认 选项 很 不 错 ， 已 能 满足 需求 。 


在 JavaScript 领域 ， 情 况 就 不 一 样 了 。 我 们 在 工作 中 使 用 YUI， 但 我 觉得 我 应 该 走出 去 
看 看 有 没有 其 他 新 推出 的 工具 。 我 被 如 此 多 的 选项 奖 没 了 jSUnit、 Mocha、 
Chutzpah、Karma、Testacular、Jasmine 等 。 而 且 还 不 仅仅 局 限于 此 : 几乎 选中 其 中 一 个 工 
具 后 (例如 Mocha ) ， 我 还 得 选择 一 个 断言 框架 & 和 报告 程序 ， 或 许 还 要 选择 一 个 模拟 技术 
库 一 一 永远 没有 终点 。 


最 终 ， 我 决定 我 们 应 该 使 用 QUnit (http://qunitjs.com/)， 因 为 它 简 单 ， 而 且 能 很 好 地 和 
jQuery 配合 使 用 。 


在 lists/static 中 新 建 一 个 目录 ， 将 其 命名 为 tests， 把 QUnit JavaScript 和 CSS 两 个 文件 下 载 
到 该 目录 ; 如 果 必 要 的 话 ， 去 掉 文 件 名 中 的 版 本 号 (我 下 载 的 是 1.12 版 )。 我 们 还 要 在 该 
目录 中 放 入 一 个 tests.html 文件 : 


$ tree lists/static/tests/ 
lists/static/tests/ 

一 qunit.css 

FE qunit.js 


上 -一 tests.html 


QUnit 的 HTML 样板 文件 内 容 如 下 ， 甚 中 包含 一 个 冒 烟 测 试 : 

































































lists/static/tests/tests.html 


<!DOCTYPE htmL> 
<html> 
<head> 
<meta charset="utf-8"> 
<title>Javascript tests</title> 
<link rel="stylesheet" href="qunit.css"> 
</head> 


<body> 
<div id="qunit"></div> 
<div id="qunit-fixture"></div> 
<script src="qunit.js"></script> 
<script> 
/*global $, test, equal */ 


test("smoke test", function () { 
equal(1, 1, "Maths works!"); 
]); 


</script> 


</body> 
</html> 




















2: 无 可 否认 , 一 旦 开始 找 Python BDD 工具 ， 情 况 会 稍微 复杂 一 些 。 
3: 纯粹 是 因为 Mocha 提供 了 NyanCat (http://visionmedia.github.io/mocha/#nyan-reporter) 测试 运行 程序 。 


- HH 
I RT 
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仔细 分 析 这 个 文件 时 ， 要 注意 几 个 重要 的 问题 : 使 用 第 一 个 <script> 标签 引入 qunitjs， 
然后 在 第 二 个 <script> 标签 中 编写 测试 的 主体 。 








你 是 不 是 想 知道 为 什么 写 /*global 这 行 注释 ?我 在 使 用 一 种 名 为 jstint 的 
工具 ， 它 集成 在 我 的 编辑 器 中 ， 是 JavaScript 句法 检查 程序 。 这 行 注 释 告 
诉 jstLint 期 望 的 全 局 变量 是 什么 ， 这 对 代码 本 身 并 不 重要 ， 所 以 不 用 担心 。 
不 过 ， 如 果 你 有 时 间 的 话 ， 我 推荐 你 了 解 一 下 这 种 JavaScript 工具 ， 例 如 
jsLint 和 jshint， 它 们 很 有 用 ， 能 防止 你 落 入 常见 的 JavaScript 陷阱 。 

















如 果 在 Web 浏览 器 中 打开 这 个 文件 〈 不 用 运行 开发 服务 器 ， 在 硬盘 中 找到 这 个 文件 即 可 )， 
会 看 到 类 似 图 13-1 所 示 的 页 面 。 











-0 v Javascript tests - Chromium 


Lv Javascript tests x 


< © | file:///home/harry/Dropbox/book/source/chapter_10/superlists/lists/static/tests/tests.html 


Javascript tests 





Hide passed tests Check for Globals No try-catch 





Mozilla15.0 (X11; Linux x86 64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu Chromium/28.0.1500.71 Chrome/28.0.1500.71 Safari/537.36 


Tests completed in 51 milliseconds. 
1 assertions of 1 passed, 0 failed. 


1. smoke test (0, 1, 1) 











13-1: QUnit 的 基本 界面 
查看 测试 代码 会 发 现 ， 和 我 们 目前 编写 的 Python 测试 有 很 多 相似 之 处 : 


test("smoke test", function () { /1 9 
equal(1, 1, "Maths works!"); // @ 
]); 


@ test 国 数 定义 一 个 测试 用 例 ， 有 点 儿 类 似 Python 中 的 def test_something(self)。test 
函数 的 第 一 个 参数 是 测试 名 ， 第 二 个 参数 是 一 个 函数 ， 定 义 这 个 测试 的 主体 。 








@ equal 函数 是 一 个 断言 ， 和 assertEqual 非常 像 ， 比 较 两 个 参数 的 值 。 不 过 ， 和 在 Python 
中 不 同 的 是 ， 不 管 失 败 还 是 通过 都 会 显示 消息 ， 所 以 消息 应 该 使 用 肯定 式 而 不 是 否定 式 。 


为 什么 不 修改 这 些 参 数 ， 故 意 让 测试 失败 ， 看 看 效果 如 何 呢 ? 


13.3 ”使 用 Query 和 <div> 固 件 元 素 


来 熟悉 一 下 这 个 测试 框架 能 做 什么 ， 也 开始 使 用 一 些 jQuery。 





如 果 你 从 未 用 过 jQuery， 在 行文 的 过 程 中 我 会 尝试 解说 ， 以 防 你 完全 不 懂 。 这 
不 是 jQuery 教程 ， 所 以 在 阅读 本 章 的 过 程 中 最 好 抽出 一 两 个 小 时 研究 jQuery。 














下 面 在 脚本 中 加 入 jQuery， 以 及 测试 中 要 使 用 的 儿 个 元 素 : 


lists/static/tests/tests.html 
<div id="qunit-fixture"></div> 
<form> 种 
<input name="text" /> 


<div class="has-error">Error text</div> 
</form> 


<script src="http://code.jquery.com/jquery.min.js"></script> 
<script src="qunit.js"></script> 
<script> 

/*global $, test, equal */ 


test("smoke test", function () { 
equal(s$('.has-error').is(':visible'), true); //@© 
$('.has-error').hide(); //@ 
equal($('.has-error').is(':visible'), false); //©@ 
]); 


</script> 

@ <form> 及 其 中 的 内 容 放 在 那儿 是 为 了 表示 真实 的 清单 页 面 中 的 内 容 。 

@ jQuery 魔法 从 这 里 开始 ! $ 是 jQuery 的 瑞士 军刀 ， 用 来 查找 DOM 中 的 内 容 。$ 的 第 一 
个 参数 是 CSS 选择 符 ， 要 查找 类 为 “error” 的 所 有 元 素 。 查 找 得 到 的 结果 是 一 个 对 象 ， 
表示 一 个 或 多 个 DOM 元 素 。 然 后 ， 可 以 在 这 个 对 象 上 使 用 很 多 有 用 的 方法 处 理 或 者 查 

@ 其 中 一 个 方法 是 .is， 它 的 作用 是 指出 某 个 元 素 的 表现 是 否 和 指定 的 CSS 属性 匹配 。 这 
里 使 用 :visible 检查 元 素 是 否 显示 出 来 。 


@ 使 用 jQuery 提供 的 .hide() 方法 陷 藏 这 个 <div> 元 素 。 其 实 ， 这 个 方法 是 在 元 素 上 动态 
设 定 style="display: none" 属性 。 
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@ 最 后 ， 使 用 第 二 个 equal 断言 检查 隐藏 是 否 成 功 。 
刷新 浏览 器 后 应 该 会 看 到 所 有 测试 都 通过 了 。 


在 浏览 器 中 期 望 QUnit 得 到 的 结果 如 下 : 


2 





2 assertions of 2 passed, 0 failed. 
1. smoke test (0, 2, 2) 





下 面 要 介绍 如 何 使 用 固件 (fixture)。 直 接 复制 测试 : 











lists/static/tests/tests.html 


<script> 
/*global $, test, equal */ 


test("smoke test", function () { 
equal($('.has-error').is(':visible'), true); 
$('.has-error').hide(); 
equal($('.has-error').is(':visible'), false); 

]); 

test("smoke test 2", function () { 
equal($('.has-error').is(':visible'), true); 
$('.has-error').hide(); 
equal($('.has-error').is(':visible'), false); 


}); 


</script> 


其 中 一 个 测试 失败 了 ， 有 点 儿 出 乎 预料 ， 如 图 13-2 所 示 。 











和 


-oo * Javascript tests - Chromium 


LL x Javascript tests X \ 





《 © | file:///home/harry/Dropbox/book/source/chapter_10/superlists/lists/static/tests/tests.html 灾 


Javascript tests 


Hide passed tests WU Check for Globals U No try-catch 


Mozillals.0 (X11; Linux x86_64) AppleWebKit537.36 (KHTML, like Gecko) Ubuntu Chromium/28.0.1500.71 Chrome/28.0.1500.71 Safari/537.36 





Tests completed in 24 milliseconds. 
3 assertions of 4 passed, 1 failed. 


1. smoke test (0, 2, 2) 5ms 
Rerun 
1. failed 
Expected: true 


Result: false 
Diff: true fatse 


Source: at 0bject.<anonymous> 
{file:///home/harry/Dropbox/book/source/chapter_16/superLists/Lists/static/tests/tests.htmL:27:5) 


2. okay 














图 13-2: 两 个 测试 中 有 一 个 失败 了 
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测试 失败 的 原因 是 ， 第 一 个 测试 把 显示 错误 消息 的 div 元 素 隐藏 了 ， 所 以 运行 第 二 个 测试 
时 ， 一 开始 这 个 元 素 就 是 隐藏 的 。 


QUnit 中 的 测试 不 会 按照 既定 的 顺序 运行 ， 所 以 不 要 觉得 第 一 个 测试 一 定 会 
在 第 二 个 测试 之 前 运行 。 


我 们 需要 一 种 方法 在 测试 之 间 执 行 清理 工作 ， 有 点 儿 类 似 于 setup 和 tearDpown， 或 者 像 
Django 测试 运行 程序 一 样 ， 运 行 完 每 个 测试 后 还 原 数 据 库 。id 为 qunit-fixture 的 <div> 
元 素 就 是 我 们 正在 寻找 的 方法 。 把 表单 移 到 这 个 元 素 中 : 


lists/static/tests/tests.html 


<div id="qunit"></div> 
<div id="qunit-fixture"> 
<form> 
<input name="text" /> 
<div class="has-error">Error text</div> 
</form> 
</div> 


<script src="http://code.jquery.com/jquery.min.js"></script> 





你 可 能 已 经 猜 到 了 ， 每 次 运行 测试 前 ，jQuery 都 会 还 原 这 个 固件 元 素 中 的 内 容 。 因 此 ， 两 
个 测试 都 能 通过 了 : 
4 assertions of 4 passed, 0 failed. 


1. smoke test (0, 2, 2) 
2. smoke test 2 (0, 2, 2) 


13.4 为 想 要 实现 的 功能 编写 JavaScript 单 元 测试 


现在 我 们 已 经 熟悉 这 个 JavaScript 测试 工具 了 ， 所 以 可 以 只 留 下 一 个 测试 ， 开 始 编写 真正 
的 测试 代码 了 : 


lists/static/tests/tests.html 
<script> 
/*global $, test, equal */ 


test("errors should be hidden on keypress", function () { 
$('input').trigger('keypress'); // 上 
equal($('.has-error').is(':visible'), false); 


]); 
</script> 


@ jQuery 提供 的 .trigger 方法 主要 用 于 测试 ， 作 用 是 在 指定 的 元 素 上 触发 一 个 JavaScript 
DOM 事件 。 这 里 使 用 的 是 keypress 事件 ， 当 用 户 在 指定 的 输入 框 中 输入 内 容 时 ， 浏 览 
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器 就 会 触发 这 个 事件 。 





这 里 jQuery 隐藏 了 很 多 复杂 的 细 节 。 不 同 浏 览 器 之 间 处 理事 件 的 方式 大 不 
一 样 ， 详 情 请 访问 Quirksmode.org (http:/www.quirksmode.org/dom/events/ 
index.html) 。jQuery 之 所 以 这 么 受 欢迎 就 是 因为 它 消除 了 这 些 差异 。 























这 个 测试 的 结果 为 : 


0 assertions of 1 passed, 1 failed. 
1. errors should be hidden on keypress (1, 0, 1) 
1. failed 
Expected: false 
Result: true 


假设 我 们 想 把 代码 放 在 单独 的 JavaScript 文件 中 ， 命 名 为 list.js。 





lists/static/tests/tests.html 


<script src="qunit.js"></script> 
<script src="../list.js"></script> 
<script> 


想 让 这 个 测试 通过 ， 所 需 的 最 简 代 码 如 下 所 示 : 


并 


lists/static/list.js 
$('.has-error').hide(); 


显然 还 有 个 问题 ， 最 好 再 添加 一 个 测试 : 


lists/static/tests/tests.html 


test("errors should be hidden on keypress", function () { 
$('input').trigger('keypress'); 
equal($('.has-error').is(':visible'), false); 


}); 


test("errors not be hidden unless there is a keypress", function () { 
equal($('.has-error').is(':visible'), true); 


}); 
得 到 一 个 预期 的 失败 : 


1 assertions of 2 passed, 1 failed. 
1. errors should be hidden on keypress (0, 1, 1) 
2. errors not be hidden unless there is a keypress (1, 0, 1) 
1. failed 
Expected: true 
Result: false 
Diff: true false 





然后 ， 可 以 使 用 一 种 更 真实 的 实现 方式 : 





lists/static/list.js 


$('input').on('keypress', function () { //©@ 
$('.has-error').hide(); 
]); 


@ 这 行 代码 的 意思 是 : 查找 所 有 input 元 素 ， 然 后 在 找到 的 每 个 元 素 上 附属 一 个 事件 监 
听 器 ， 作 用 在 keypress 事件 上 。 事 件 监听 器 是 那个 行 间 函数 ， 其 作用 是 隐藏 类 为 .has- 
error 的 所 有 元 素 。 


这 段 代码 能 让 单元 测试 通过 : 

















2 assertions of 2 passed, 0 failed. 





很 好 。 那 么 在 所 有 页 面 中 都 引入 这 个 脚本 和 jQuery 吧 : 


lists/templates/base.html (ch141014) 
</div> 
<script src="http://code.jquery.com/jquery.min.js"></script> 
<script src="/static/list.js"></script> 
</body> 


</html> 





习惯 做 法 是 在 HTML 的 body 元 素 未 尾 引 入 脚本 ， 因 为 这 么 做 用 户 无 需 等 到 
所 有 JavaScript 都 加 载 完 才 能 看 到 页 面 中 的 内 容 。 而 且 还 能 保证 运行 脚本 前 
加 载 了 大 部 分 DOM。 

















然后 运行 功能 测试 


$ python3 manage.py test functional._tests.test_ list item validation.\ 
ItemValidationTest.test_error_messages_are_cleared_on_input 


[ass 
Ran 1 test in 3.023s 


OK 


太 棒 了 ! 这 里 要 做 次 提交 。 


13.5_ JavaScript 测试 在 TDD 循 环 中 的 位 置 


你 可 能 想 知 道 JavaScript 测试 在 双重 TDD 循环 中 处 于 什么 位 置 。 答 案 是 ，JavaScript 测试 
和 Python 单元 测试 扮演 的 角色 完全 相同 。 
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(1) 编写 一 个 功能 测试 ， 看 着 它 失 败 。 





(2) 判断 接 下 来 需要 哪 种 代码 ，Python 还 是 JavaScript ? 
(3) 使 用 选中 的 语言 编写 单元 测试 ， 看 着 它 失败 。 





(4) 使 用 选中 的 语言 编写 一 些 代码 ， 让 测试 通过 。 
(5) 重复 上 述 步骤 。 





想 更 多 的 练习 使 用 JavaScript 吗 ? 当 用 户 在 输入 框 内 点 击 或 者 输入 内 容 时 ， 
看 看 你 能 否 隐藏 错误 消息 。 实 现 的 过 程 中 应 该 还 要 编写 功能 测试 。 


2 全 ey 和 
13.6 ”经 验 做 法 : onload 样 板 代 码 和 命名 空间 
噢 ， 最 后 还 有 一 件 事 。 如 果 JavaScript 需要 和 DOM 交互 ， 最 好 把 相应 的 代码 包含 在 
onload 样板 代码 中 ， 确 保 在 执行 脚本 之 前 完全 加 载 了 页 面 。 目 前 的 做 法 也 能 正常 运行 ， 因 
为 我 们 把 <script> 标签 放 在 页 面 的 底部 ， 但 不 能 依赖 这 种 方式 。 




















jQuery 提供 的 ontoad 样板 代码 非常 简洁 : 





lists/static/list.js 


$(document).ready(function () { 
$('input').on('keypress', function () { 
$('.has-error').hide(); 
}); 
]); 











此 外 ， 还 使 用 了 jQuery 提供 的 神奇 $ 函数 ,但 是 其 他 JavaScript 库 可 能 也 会 使 用 这 个 名 字 。 
$ 其 实 是 jQuery 的 别名 ，jQuery 这 个 名 字 在 其 他 库 很 少 会 用 到 ， 所 以 更 精确 地 控制 命名 空 
间 的 标准 方法 如 下 : 





lists/static/list.js 


jQuery(document).ready(function ($) { 
$('input').on('keypress', function () { 
$s('.has-error').hide(); 
}); 
]); 


更 多 信息 请 阅读 jQuery .ready() 的 文档 (http://api.jquery.com/ready/)。 
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我 们 几乎 可 以 进入 第 三 部 分 了 ， 但 在 此 之 前 还 有 最 后 一 步 ， 把 修改 后 的 新 代码 部 署 到 服务 
器 中 。 


13.7 一 些 缺 憾 





选择 符 $(input) 的 作用 太 大 了 ， 它 为 页 面 中 所 有 的 input 元 素 都 附 上 了 事件 句柄 。 试 
着 添加 一 个 点 击 事件 句柄 ， 然 后 你 就 会 看 出 为 什么 这 是 个 问题 。 请 把 这 个 选择 符 改 得 更 
精确 一 些 ! 




















目前 ， 测 试 只 检查 JavaScript 能 否 在 一 个 页 面 中 使 用 。JavaScript 能 使 用 ， 是 因为 在 

















base.html 中 引入 了 JavaScript 文件 。 如 果 只 在 home.html 中 引入 JavaScript 文件 ， 测 试 
也 能 通过 。 你 可 以 选择 在 哪个 文件 中 引入 ， 但 也 可 以 再 编写 一 个 测试 。 











JavaScript 测试 笔记 
Selenium 最 大 的 优势 之 一 是 可 以 测试 JavaScript 是 否 真 的 能 使 用 ， 就 像 测试 Python 
代码 一 样 。 
JavaScript 测试 运行 库 有 很 多 ，QUnit 和 jQuery 联系 紧密 ， 这 是 我 选择 使 用 它 的 主 
要 原因 。 
QUnit 主要 项 望 你 在 真正 的 Web 浏览 器 中 运行 测试 。 这 就 带 来 一 个 好 处 ， 可 以 方便 
地 创建 一 些 HTML 固件 ， 匹 配 网 站 中 真正 含有 的 HTML， 在 测试 中 使 用 。 
我 说 JavaScript 很 糟糕 并 不 是 出 于 真心 。JavaScript 其 实 也 可 以 很 有 趣 。 不 过 我 还 是 
要 再 说 一 次 : 一 定 要 阅读 《JavaScript 语言 精粹 》。 
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第 14 章 


部 署 新 代码 





现在 可 以 把 全 新 的 验证 代码 部 署 到 线 上 服务 器 了 。 借 此 机 会 ， 我 们 也 能 再 次 在 实践 中 使 用 
自动 化 部 署 脚 本 。 


此 刻 ， 我 由 庙 地 感谢 Andrew Godwin 和 整个 Django 团队 。 在 Django 1.7 之 
前 ， 我 写 了 很 长 一 节 内 容 ， 专 门 说 明 如 何 迁 移 。 现 在 ， 因 为 迁移 可 以 自动 执 
行 ， 所 以 那 整 节 内 容 都 不 需要 了 。 感 谢 你 们 的 辛勤 工作 。 














音 过 渡 服 务 

14.1 部署 到 过 渡 服 务 器 
先 部 团 到 过 渡 服 务 器 中 : 

$ cd deploy_tools 

$ fab deploy:host=elspeth@superlists-staging.ottg.eu 

Disconnecting from superlists-staging.ottg.eu... done. 
重启 Gunicorn: 

elspeth@server:$ sudo restart gunicorn-superlists.ottg.eu 
然后 在 过 渡 服 务 器 中 运行 测试 : 


$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
OK 
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14.2” 部署 到 线 上 服务 器 
假设 在 过 渡 服 务 器 上 一 切 正常 ， 那 么 就 可 以 运行 脚本 ， 部 署 到 线 上 服务 器 : 


$ fab deploy:host=elspeth@superlists.ottg.eu 


14.3 ”如 果 看 到 数据 库 错 误 该 怎么 办 

迁移 中 引入 了 一 个 完整 性 约 来， 你 可 能 会 发 现 迁移 执行 失败 ， 因 为 某 些 现 有 的 数据 违背 了 
约束 规则 。 

此 时 有 两 个 选择 。 


。 删除 服务 器 中 的 数据 库 ， 然 后 再 部 署 试 试 。 毕 竟 这 只 是 一 个 小 项 目 | 
。 或 者 ， 学 习 如 何 迁 移 数据 (参见 附录 D)。 


14.4 总结: 为 这 次 新 发 布 打 上 Git 标 签 
最 后 要 做 的 一 件 事 是 ， 在 VCS 中 为 这 次 发 布 打 上 标签 一 一 始终 能 跟踪 线 上 运行 的 是 哪个 
版 本 十 分 重要 : 

$ git tag -f LIVE # 需要 指定 -f, 因 为 我 们 要 替换 旧 标 签 

$ export TAG= `date +DEPLOYED-%F /%H%M ~ 


$ git tag $TAG 
$ git push -f origin LIVE STAG 














有 些 人 不 喜欢 使 用 push -f， 也 不 喜欢 更 新 现 有 的 标签 ， 而 是 使 用 某 种 版 本 
号 标记 每 次 发 布 。 你 觉得 哪 种 方法 好 就 用 哪 种 。 

















至 此 ， 第 二 部 分 结束 了 。 接 下 来 我 们 要 进入 第 三 部 分 ， 介 绍 更 让 人 兴奋 的 话题 。 真 令 人 期 
待 啊 ! 
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第 三 部 分 
高 级 话题 





“ 噢 ， 天 呐 ， 什 么 ， 还 有 一 部 分 ? 哈 利 ， 我 累 了 ， 已 经 看 了 两 百 多 页 ， 觉 得 无 法 再 看 完 另 
一 部 分 了 ， 而 且 这 一 部 分 还 是 “高 级 ”话题 …… 我 能 不 能 跳 过 这 一 部 分 呢 ? ” 


噢 ， 不 ， 你 不 能 。 这 一 部 分 虽然 被 称 为 “高 级 ”话题 ， 但 其 实 有 很 多 对 TDD 和 Web 开发 
十 分 重要 的 知识 ， 因 此 不 能 跳 过 。 这 一 部 分 甚至 比 前 两 部 分 还 重要 。 


我 们 会 讨论 如 何 集 成 和 测试 第 三 方 系统 。 重 用 现 有 的 组 件 对 现代 Web 开发 十 分 重要 。 还 
会 介绍 模拟 技术 和 测试 隔离 ， 这 两 种 技术 是 TDD 的 核心 ， 而 且 在 最 简单 的 代码 基 中 也 会 
用 到 。 最 后 要 讨论 服务 器 端 调试 技术 和 测试 固件 ， 以 及 如 何 搭建 持续 集成 (Continuous 
Integration) 环境 。 这 些 技术 在 项 目 中 并 不 是 可 有 可 无 的 奢侈 附属 品 ， 它 们 其 实 都 很 重要 。 








这 一 部 分 的 学 习 曲 线 难免 稍微 陡峭 一 些 。 你 可 能 要 多 读 几 遍 才 能 领会 ， 或 者 第 一 次 操 
作 时 可 能 无 法 正常 运行 ， 需要 自己 调试 一 番 。 但 要 坚持 下 去 ， 知 识 越 难 ， 只 要 学 会 
了 ， 收 线 也 就 越 大 。 如 果 你 遇 到 难题 ， 我 十 分 乐意 帮忙 ， 请 给 我 发 电子 邮件 ， 地 址 是 


obeythetestinggoat@gmail.com 。 














来 吧 ， 我 保证 最 重要 的 知识 就 在 这 一 部 分 ! 
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第 15 章 
用 户 认 证 、 集 成 第 三 方 插件 以 及 
JavaScript 模 拟 技术 的 使 用 





精美 的 待 办 事项 清单 网 站 上 线 好 儿 天 了， 用户 开 始 提供 反馈 。 他 们 说 :“ 我 们 喜欢 这 个 网 
站 ， 但 总 是 找 不 到 使 用 过 的 清单 ， 又 很 难 靠 死记 硬 背 来 记 住 URL。 如 果 网 站 能 记 住 我 们 创 
建 过 哪些 清单 就 好 了 。” 
































还 记得 亭 利 . 福特 说 过 的 那 名 “ 快 马 ”名 言 吗 ?”“ 收 到 用 户 的 反馈 后 一 定 要 深入 分 析 并 
思 芳 :“ 用 户 真正 需要 的 是 什么 ? 满足 用 户 的 需求 时 如 何 使 用 自己 一 直 想 尝试 的 酷 炫 
新 技术 ? “ 


很 明显 ， 这 些 用 户 需 要 的 是 某 种 用 户 账户 系统 。 那 么 就 直接 实现 认证 功能 吧 。 





我 们 不 会 费力 气 自己 存储 密码 ， 这 是 上 世纪 90 年 代 的 技术 ， 而 且 存储 用 户 密 码 还 是 个 
安全 璐 梦 ， 所 以 还 是 交 给 第 三 方 去 完成 吧 。 我 们 要 使 用 一 种 联合 认证 系统 (Federated 


Authentication System ) 。 

















如 果 你 坚持 要 自己 存储 密码 ， 可 以 使 用 Django 提供 的 auth 模块 。 这 个 模块 很 友好 也 很 简 
单 ， 有 具体 的 实现 方法 留 给 你 自己 去 发 掘 。 


4 











注 1: 享 利 :福特 是 福特 汽车 公司 的 创始 人 。 这 里 所 说 的 “ 快 马 ” 名 言 全 句 是 :“If I had asked people what 
they wanted, they would have said faster horses.” 但 也 有 人 说 福特 并 没 说 过 这 和 句 话 ， 参 见 http://blogs.hbr. 
org/2011/08/henry-ford-never-said-the-fast/。 译 者 注 
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本 章 我 们 会 深入 介绍 一 种 测试 技术 ， 即 “模拟 ”(mocking)。 我 自己 花 了 好 几 周 时 间 才 真 
正 理 解 模拟 技术 ， 所 以 如 果 你 一 开始 不 理解 也 不 用 担心 。 这 一 章 会 在 JavaScript 代码 中 多 
次 用 到 模拟 技术 ， 下 一 章 还 要 在 Python 代码 中 使 用 ， 届 时 理解 起 来 可 能 更 简单 。 我 建议 你 
先 读 完 这 两 章 ， 对 模拟 技术 有 个 整体 的 认识 ， 然 后 再 回来 阅读 第 二 遍 ， 看 看 是 否 能 更 好 地 
理解 这 些 步骤 。 





如 果 你 觉得 哪些 内 容 没 有 解释 清楚 ， 或 者 速度 太 快 ， 请 给 我 发 邮件 ， 地 址 是 


obeythetestinggoat@ gmail.com。 





15.1 Mozilla Persona (BrowserlD) 


我 们 要 使 用 哪 种 联合 认证 系统 呢 ? Oauth，Openid， 还 是 “使 用 Facebook 登录 ”? 对 本 书 
而 言 ， 这 些 认证 系统 都 有 让 人 无 法 接受 的 负面 作用 。 为 什么 要 让 谷歌 和 Facebook 知道 我 何 
时 登录 过 什么 网 站 呢 ?” 幸 好 技术 界 还 有 一 些 理想 主义 嬉 皮 士 ，Mozilla 可 爱 的 开发 者 研发 了 
一 种 注重 隐私 的 认证 机 制 ， 叫 “Persona”， 也 叫 “BrowserID 。 


这 种 机 制 的 原理 是 ， 把 Web 浏览 器 作为 中 间 人 ， 连 接 想 要 检查 ID 的 网 站 和 作为 ID 担保 
人 的 网 站 。ID 担保 人 可 以 是 谷歌 或 Facebook 等 任何 网 站 ，Persona 使 用 的 协议 很 明智 ， 它 
们 绝 不 知道 你 登录 过 哪些 网 站 以 及 何 时 登录 。 





Persona 最 终 可 能 无 法 成 为 认证 平台 ， 但 后 面 几 章 的 主要 内 容 必须 保持 一 致 ， 即 不 管 集成 
哪 种 第 三 方 认 证 系统 ， 都 要 做 到 以 下 几 点 : 

。 不 测试 别人 的 代码 和 API; 

。 但 要 测试 是 否 正确 地 把 它们 集成 到 自己 的 代码 中 ， 

。 从 用 户 的 角度 出 发 ， 检 查 一 切 是 否 可 以 正常 运行 ， 

。 测试 第 三 方 系统 不 可 用 时 你 的 网 站 是 否 能 优雅 降级 。 


15.2 ”探索 性 编程 (又 名 “探究 ”) 


在 撰写 本 章 之 前 ,我 只 是 在 Dan Callahan 在 PyCon 所 做 的 演讲 中 见 过 Persona。 在 那 次 演讲 中 ， 
他 承诺 只 需 30 行 代码 就 能 集成 Persona， 然 后 做 了 一 个 演示 。 也 就 是 说 ， 我 并 不 了 解 Persona。 








在 第 10、11 章 中 我 们 见识 到 ， 可 以 使 用 单元 测试 探索 新 API 的 用 法 。 但 有 时 你 不 想 写 测 
试 ， 只 是 想 揭 鼓 一 下 ,看 API 是 否 能 用 ， 目 的 是 学 习 和 领会 。 这 人 么 做 绝对 可 行 。 学 习 新 工 
具 ， 或 者 研究 新 的 可 行 性 方案 时 ， 一 般 都 可 以 适当 地 把 严格 的 TDD 流程 放 在 一 边 ， 不 编 




















注 2: Dan Callahan 是 Mozilla 的 员工 ， 负 责 Persona 开发 。 一 一 译 者 注 
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写 测试 或 编写 少量 的 测试 ， 先 把 基本 的 原型 开发 出 来 。 测 试 山羊 并 不 介意 暂时 睁 一 只 眼 闭 
一 只 有 眼 。 

















这 种 创建 原型 的 过 程 一 般 叫 作 “ 探 究 ”(spike)。 这 么 叫 的 原因 众所周知 (http://stackoverflow. 
com/questions/249969/why-are-tdd-spikes-called-spikes)。 


首先 ， 我 研究 了 一 个 现 有 的 Django-Persona 集成 方案 一 一 Django-BrowserID (https://github. 
com/mozilla/django-browserid) ， 可 惜 它 不 支持 Python 3。 当 你 阅读 到 这 里 时 ， 我 相信 它 已 
经 可 以 支持 Python 3 了 ， 但 对 我 影响 不 大 ， 因 为 我 更 期 待 自己 编写 集成 代码 。 























我 用 了 大 约 三 个 小 时 ， 借 览 了 Dan 在 其 演讲 中 提 到 的 代码 和 Persona 网 站 (https:/ 
developer.mozilla.org/en-US/docs/Mozilla/Persona) 中 的 示例 代码 ， 最 终 写 出 了 刚好 能 用 的 
代码 。 下 面 我 要 向 你 展示 实现 的 过 程 ， 然 后 再 过 一 遍 ， 去 掉 探 索性 代码 。 


你 应 该 自己 动手 ， 把 这 些 代 码 加 到 自己 的 网 站 中 ， 这 样 才能 得 到 试验 的 对 象 ， 然 后 使 用 自 
己 的 电子 邮件 地 址 登录 试 试 ， 证 明 这 些 代 码 确实 可 用 。 


15.2.1 为 此 次 探究 新 建 一 个 分 支 


着 手 探 究 之 前 ， 最 好 新 建 一 个 分 支 ， 这 样 就 不 用 担心 探究 过 程 中 提交 的 代码 把 VCS 中 的 
生产 代码 搞 乱 了 : 

















$ git checkout -b persona-spike 


15.2.2 前端 和 JavaScript 代 码 
先 从 前 端 入 手 。 我 直接 从 Persona 网 站 和 Dan 的 幻灯 片 中 复制 粘贴 代码 ， 然 后 做 少量 修改 : 


lists/templates/base.html (ch151001) 


<script src="http://code.jquery.com/jquery.min.js"></script> 
<script src="/static/list.js"></script> 

<script src="https://\login.persona.org/include.js"></script> 
<script> 

$(document).ready(function() { 


var loginLink = document.getELementById('Login ' ); 
if (loginLink) { 
loginLink.onclick = function() { navigator.id.request(); }; 


} 


var logoutLink = document.getELementById('Logout ' ); 
if (logoutLink) { 
logoutLink.onclick = function() { navigator.id.1logout(); }; 


} 


var currentUser = '{{ user.email }}' || null; 
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var csrf token = '{{ csrf_token }}'; 
console.log(currentUser); 


navigator .id.watch({ 
loggedInUser: currentUser, 
onlogin: function(assertion) { 
$.post('/accounts/login', {assertion: assertion, csrfmiddlewaretoken: csrf_token}) 
.done(function() { window.Tlocation.reload(); }) 
.fail(function() { navigator.id.logout();}); 
}， 
onLogout: function() { 
$.post('/accounts/logout') 
.always(function() { window.location.reload(); }); 
} 
]); 


]); 

</script> 
Persona 的 JavaScript 库 提供 了 一 个 特殊 的 对 象 navigator.id， 把 这 个 对 象 的 request 方法 
绑 定 到 登录 链接 上 (按照 通用 做 法 ， 登 录 链 接 放 在 页 面 顶部 )， 再 把 这 个 对 象 的 Logout 方 
法 绑 定 到 退出 链接 上 : 




















lists/templates/base.html (ch151002) 


<body> 
<div class="container"> 


<div class="navbar"> 
{% if user.email %} 
<p>Logged in as {{ user.email}}</p> 
<p><a id="logout" href="{% url 'logout' %}">Sign out</a></p> 
{% else %} 
<a href="#" id="login">Sign in</a> 
{% endif %} 
<p>User: {{user}}</p> 
</div> 


<div class="row"> 


区 柯 


15.2.3 Browser-ID 协 议 

现在 ， 如 果 用 户 点 击 登 录 链 接 ，Persona 会 弹出 它 的 认证 对 话 框 。 接 下 来 发 生 的 事 体现 了 
Persona 协议 的 明智 之 处 : 用 户 输入 电子 邮件 地 址 之 后 ， 浏 览 器 负责 验证 电子 邮件 地 址 一 一 
把 用 户 引 导 到 电子 邮件 供应 商 的 网 站 (谷歌 、 雅 虎 等 ) ， 让 供应 商 验证 电子 邮件 。 






































假设 我 们 使 用 的 是 谷歌 电子 邮箱 :谷歌 会 要 求 用 户 输入 用 户 名 和 密码 ， 还 可 能 要 做 两 步 认 
证 ， 以 此 向 浏览 器 确认 你 是 不 是 你 所 声称 的 那个 人 。 然 后 谷歌 向 浏览 器 返回 一 个 证 书 ， 包 
含 用 户 的 电子 邮件 地 址 。 这 个 证 书 有 密码 签名 ， 以 证 明 是 由 谷歌 签发 的 。 


























户 认 证 、 集 成 第 三 方 插件 以 及 Javascript 模 拟 技术 的 使 用 | 231 





此 时 浏览 器 便 确信 你 确实 拥有 这 个 电子 邮件 地 址 ， 而 且 还 会 在 其 他 使 用 Persona 的 网 站 中 
重用 这 个 证 书 。 


然后 ，Persona 把 证 书 和 想 要 登录 的 网 站 域名 一 起 存 和 人 一 个 叫 作 “判定 数据 ”的 二 进 制 文 
件 ( 即 assertion)， 再 把 这 个 二 进 制 文件 发 送 给 网 站 进行 验证 


现在 代码 执行 到 navigator.id.request 和 navigator.id.watch 的 onLogin 回调 之 间 一 一 通 
过 POST 请 求 把 判定 数据 发 送 给 网 站 的 登录 URL (我 使 用 的 是 accounts/login)。 


要 在 服务 器 端 验证 传 入 的 判定 数据 ， 看 它 是 否 能 证 明 用 户 确实 拥有 这 个 电子 邮件 地 址 。 服 
务 器 之 所 以 能 验证 ， 是 因为 谷歌 使 用 它 的 公 钥 对 判定 数据 进行 了 部 分 签名 。 可 以 自己 编写 
代码 解码 ， 也 可 以 使 用 Mozilla 提供 的 公共 服务 完成 。 























是 的 ， 交 给 Mozilla 完成 完全 违背 了 保护 隐私 的 初衷 ， 但 这 是 惯用 的 方式 。 
如 果 需 要 ， 也 可 以 自己 做 。 这 一 步 留 作 练习 ， 由 读者 自己 完成 。Mozilla 的 网 
站 (https://developer.mozilla. org/en- -US/docs/Mozilla/Persona/Protocol_Overview) 
中 有 详细 说 明 ， 甚 中 包括 各 种 聪明 的 公 钥 加 密 方式 ， 能 防止 谷歌 知道 你 想 登 
录 的 网 站 ， 还 能 避免 重 放 攻击 等 。 太 高 明了 。 


























15.2.4 服务 器 端 : 自 定义 认证 机 制 


接 下 来 ， 启 动 要 实现 账户 系统 的 应 用 : 





$ python3 manage.py startapp accounts 











发 给 accounts/login 的 POST 请 求 由 下 面 这 个 视图 处 理 : 





accounts/Views.py 
import sys 
from django.contrib.auth import authenticate 
from django.contrib.auth import login as auth_login 
from django.shortcuts import redirect 


def login(request): 
print('login view', file=sys.stderr) 
# User = PersonaAuthenticationBackend().authenticate(request.POST['assertion']) 
user = authenticate(assertion=request.POST['assertion']) 
if user is not None: 
auth_login(request, user) 
return redirect('/') 


很 明显 ， 这 是 探究 时 写 下 的 代码 ， 因 为 有 行 代码 被 注释 掉 了 ， 证 明 前 期 试验 失败 了 。 


authenticate 国 数 ， 它 以 自 定义 的 人 “认证 后 台 ” 形 式 实现 (虽然 可 以 在 视图 中 
现 ， 但 使 用 后 台 是 Django 推荐 的 做 法 。 这 么 做 可 以 在 其 他 应 用 中 重用 认证 系统 ， 比 如 
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说 管理 后 台 )。 


accounts/authentication.py 


import requests 
import sys 
from accounts.models import ListUser 


class PersonaAuthenticationBackend(object): 


def authenticate(self, assertion): 
# 把 判定 数据 发 给 Mozitla 的 验证 服务 
data = {'assertion': assertion, 'audience': 'localhost'} 
print('sending to mozilla', data, file=sys.stderr) 
resp = requests.post('https://verifier.login.persona.org/verify', data=data) 
print('got', resp.content, file=sys.stderr) 


# 验证 服务 是 否 有 响应 ? 
if resp.ok: 
# 解析 响应 


verification data = resp.json() 


# 检查 判定 数据 是 否 有 效 


if verification data['status'] == 'okay': 
email = verification data['email'] 
try: 


return self.get user(email) 
except ListUser .DoesNotExist: 
return ListUser .objects.create(email=email) 


def get user(self, email): 
return ListUser.objects.get(email=email) 


从 解说 性 的 注释 可 以 看 出 ， 这 段 代码 是 直接 从 Mozilla 的 网 站 上 复制 粘贴 过 来 的 。 


需要 执行 pip instaLL requests 命令 把 requests 库 (http://docs.python-requests.org/) 安 
装 到 虚拟 环境 中 。 如 果 你 从 未 用 过 这 个 库 ， 我 告诉 你 ，requests 是 Python 标准 库 中 处 理 
HTTP 请 求 相 关 工具 的 上 佳 赫 代 品 。 

















为 了 完成 Django 中 自 定 义 认 证 后 台 的 操作 ， 还 需要 一 个 自 定 义 用 户 模型 : 





accounts/models.py. 


from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin 
from django.db import models 


class ListUser(AbstractBaseUser, PermissionsMixin): 
email = models.EmailField(primary_key=True) 
USERNAME_FIELD = 'email' 
#REQUIRED_FIELDS = ['email', 'height'] 


objects = ListUserManager() 
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@property 
def is_staff(self): 
return self.email == 'harry.percivaLQexampLe.com' 


@property 
def is active(self): 
return True 


这 个 模型 只 有 一 个 字段 ， 没 有 多 余 的 名 字 、 姓 和 用 户 名 字段 ， 显 然 也 没有 密 
码 字 段 一 一 密码 由 他 人 代为 存储 。 这 就 是 我 把 它 叫 作 最 简 用 户 模 型 的 原因 |! 
不 过 ， 从 注释 掉 的 代码 行 和 硬 编码 的 电子 邮件 地 址 可 以 看 出 ， 这 段 代码 不 能 
在 生产 中 使 用 。 

















此 时 ， 我 建议 你 稍微 浏览 一 下 Django 的 认证 文档 (https://docs.djangoproject.com/en/1.7/ 


topics/auth/customizing/) 。 




















除 此 之 外 ， 还 要 为 用 户 提供 一 个 模型 管理 器 : 
accounts/models.py (ch151006) 


from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin 


class ListUserManager(BaseUserManager): 


def create user(self, email): 
ListUser .objects.create(email=email) 


def create_ superuser(self, email, password): 
self.create_ user(email) 


退出 视图 如 下 : 
accounts/views.py (ch151007) 


from django.contrib.auth import login as auth_ login, logout as auth logout 


[i 


def logout(request): 
auth_Logout(request) 
return redirect('/') 


然后 定义 这 两 个 视图 的 URL 映射 : 
superlists/urls.py (ch151008) 


urlpatterns = patterns('', 
url(r'^$', 'lists.views.home page', name='home'), 
url(r'^lists/', include('lists.urls')), 
url(r'^accounts/', include('accounts.urls')), 
# url(r'^admin/', include(admin.site.urls)), 
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再 修改 下 面 这 个 文件 : 











accounts/urls.py 
from django.conf.urls import patterns, url 
urlpatterns = patterns('', 
url(r'^login$', 'accounts.views.login', name="'login'), 
url(r'^logout$', 'accounts.views.logout', name='logout'), 


) 
就 快 完成 了 。 还 要 在 settings.py 中 启用 认证 后 台 和 刚 编 写 好 的 账户 应 用 : 





superlists/settings.py 


INSTALLED_APPS = ( 
#'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'lists', 

'accounts', 


) 


AUTH_USER_MODEL = 'accounts.ListUser’ 
AUTHENTICATION_BACKENDS = ( 
'accounts .authentication.PersonaAuthenticationBackend', 


) 
MIDDLEWARE_CLASSES = (人 
[< 


然后 执行 makemigrations 命令 ， 让 刚才 定义 好 的 用 户 模型 生效 : 


$ python3 manage.py makemigrations 
Migrations for "acCounts ' : 
0001_initial.py: 
- Create model ListUser 


再 执行 mtgrate 命令 ， 更 新 数据 库 : 





$ python3 manage.py migrate 
Ex::s] 
Running migrations: 

Applying accounts.0001 initial... OK 


至 此 ， 应 该 全 部 完成 了 。 为 什么 不 执行 runserver 命令 启动 开发 服务 器 看 一 下 效果 呢 (如 
图 15-1) ? 























差不多 就 是 这 样 了 ! 实现 的 过 程 中 我 遇 到 了 很 多 难题 ， 包 括 在 Firefox 终端 手动 调试 Ajax 
请 求 (如 图 15-2) ， 遇 到 页 面 无 限 循环 刷新 ， 以 及 多 次 因为 自 定 义 的 用 户 模型 缺少 属性 被 
卡 住 (因为 我 没 认 真 阅读 文档 )。 有 一 次 我 甚至 为 了 解决 一 个 问题 换 用 了 Django 开发 版 ， 
幸好 最 终 证 实 不 是 Django 的 问题 。 
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所 @ localhost "© 图 .pyconpl 


Sign in 
User AnonymousUser 
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Mozilla Persona: A Better Way to Sign In - Mozilla Firefox 







a Foundation (US) persona.org, 


Sign in to localhost as... 


harry.percivalegmail.com 


Add another emaladdress Thk 5 not me 


localhost 








mple sign-in from the non-pro 









其 Find: A 
加，x 














15-1: 可 以 使 用 了 ， 可 以 使 用 了 ! 哇 哈 哈哈 哈 








To-Do lists - Mozilla Firefox (Private Browsing) 3 
File Edit View History Bookmarks Tools Help 
B39 jaTopolists [| 
"© 


图 - 


《 @ localhost 基 


Superlists 


File 
/ 


bootstrap.min.css 
base.css 

jquery.minjs 

include.js 

accounts.js 

listjs 
communication_iframe 
communication_iframe.js 
dialog.js 

session_context 
dialog.css 

grain.png 
persona-logo-transparent.png 
arrow_grey.png 

ToDO 


JS XHR 





Fonts 


Domain 


localhost:8000 
localhost:8000 
localhost8000 
code.jquery.com 
login.persona.org 
localhost:8000 
localhost:8000 





login.persona.org 

static.login.persona.org 
static.login.persona.org 
login.persona.org 

static.login.persona.org 
static.login.persona.org 
static.login.persona.org 
static.login.persona.org 


localhost8000 html 


Media Flash 


Images 


Network 


Headers kies Params 


Request URL: http://localhost:8090/TODO 
Request method: POST 
Status code: © 404 NOT FOUND 


Version: HTTP/1.0 


Edit and Red 


Response headers (0.152 KB) 
Content-Type "text/html" 

Date "Tue, 15 Apr 2014 20:36:39 GMT" 
Server "WSGlIServer/0.2 CPython/3.3.2+" 
X-Frame-Options "SAMEORIGIN" 
Request headers (0.481 KB) 

Host "localhost:8000" 

User-Agent "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:27.0) Geck 
Accept "*/*" 

Accept-Language "en-gb,en;q=0.5" 

Accept-Encoding "gzip, deflate" 

DNT "1" 

Content-Type "application/x-www-form-urlencoded; charset=UTI 
X-Requested-With "XMLHttpRequest” 








5 

















如 果 手 动 调试 时 Persona 不 起 作用 ， 而 且 在 终端 里 看 到 “audience mismatch” 
错误 ， 确 认 你 访问 网 站 使 用 的 地 址 是 http://localhost:8000， 而 不 是 127.0.0.1。 





旁 注 : 把 日 志 输 出 到 标准 错误 
ea 能 0 代码 抛 出 的 异常 。Django 很 讨厌 ， 默 认 情 况 下 并 没 把 所 有 异常 都 输 
送 到 终端， 不 过 可 以 在 settings.py 中 使 用 LOGGING 变量 让 Django 这 么 做 : 


superlists/settings.py (ch151011) 


LOGGING = { 
'version': 1， 
'disable existing loggers': False, 
'handlers': { 
'console': { 
"LeveL ' : 'DEBUG ' ， 
'class': "Logging.StreamHandLer ' ， 
}， 
}， 
'loggers': { 
'django': { 
'handlers': ['console'], 
}， 
}， 
'root': {'level': 'INFO'}, 
} 


Django 使 用 Python 标准 库 中 的 企业 级 日 志 模 块 。 这 个 模块 虽然 功能 完善 ， 但 学 习 曲 
线 十 分 陡峭 ， 在 第 17 章 和 Django 文档 (https://docs.djangoproject.com/en/1.7/topics/ 
logging/) 中 都 有 简略 介绍 。 








现在 我 们 实现 了 一 个 可 用 的 解决 方案 ， 把 这 些 代 码 提交 到 探究 时 使 用 的 分 支 吧 : 


$ git status 
$ git add accounts 
$ git commit -am"spiked in custom auth backend with persona" 


现在 该 去 掉 探 究 代 码 了 。 


15.3 去掉 探 究 代码 


去 掉 探 究 代码 意味 着 要 使 用 TDD 重 写 原 型 代码 。 我 们 现在 掌握 了 足够 的 信息 ， 知 道 怎么 
做 才 是 对 的 。 那 第 一 步 做 什么 呢 ? 当然 是 编写 功能 测试 ! 


我 们 还 得 继续 待 在 persona-spike 分 文中 ， 看 功能 测试 能 否 在 探究 代码 中 通过 ， 然 后 再 回 
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到 master 分 支 ， 并 且 只 提交 功能 测试 。 





功能 测试 的 大 纲 如 下 : 


functional tests/test login.py 


from .base import FunctionalTest 


class LoginTest(FunctionalTest): 


def test login with_ persona(self): 





# 伊 迪 丝 访问 这 个 很 棒 的 超级 列表 网 站 

# 第 一 次 注意 到 “Sign in ”链接 

seLf .browser .get(self.server_url) 

seLf .browser .find_eLement_by_id('Login').cLick() 


# 出 现 一 个 Persona 登 录 框 
self.switch to _ new window('Mozilla Persona' ) #0 























# 伊 迪 丝 使 用 她 的 电子 邮件 地 址 登录 
寿 测 试 中 的 电子 邮件 使 用 mockmyid.com 
self.browser .find_ element_ by_id( 
'authentication email' #@ 
) .send_keys('edith@mockmyid.com') #@ 
self.browser .find element_ by_tag_name('button').click() 





# Persona 窗 口 关闭 
self.switch to_ new window('To-Do') 





# 她 发 现 自己 已 经 登录 

self.wait for_element with id('logout') #@ 

navbar = self.browser.find element by_css_selector(' .navbar') 
self.assertIn('edith@mockmyid.com', navbar.text) 





9 @ 这 个 功能 测试 需要 两 个 辅助 函数 ， 它 们 都 用 于 实现 Selenium 测试 中 十 分 常见 的 操作 : 
等 待 某 件 事 发 生 。 辅 助 函数 的 定义 见 后 文 。 


我 使 用 如 下 方法 查找 Persona 电子 邮件 输入 框 的 及: 手动 打开 网 站 ， 使 用 Firefox 调 


试 工具 条 (CtrltShift+1)。 如 图 15-3 所 示 。 




















我 们 没有 使 用 真实 的 电子 邮件 地 址 ， 而 是 用 虚拟 工具 生成 的 地 址 ， 因 此 不 用 在 邮件 服 
务 供应 商 的 网 站 上 填写 认证 信息 。 虚 拟 工 具 可 以 使 用 MockMyID (https://github.com/ 


callahad/mockmyid) 或 者 Persona Test User (http://personatestuser.org/) 





3 
o 





注 3: MockMyID 的 网 站 打 不 开 了 ， 所 以 换 用 GitHub 中 的 仓库 地 址 。 一 一 译 者 注 
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评估 第 三 方 系统 的 测试 基础 设施 


测试 是 评估 第 三 方 系统 的 一 部 分 。 集 成 外 部 服务 时 ， 要 想 清 楚 如 何在 功能 测试 中 使 用 
这 项 服务 。 


测试 通常 可 以 使 用 和 真实 环境 中 一 样 的 服务 ， 但 有 时 需要 使 用 第 三 方 服务 的 “测试 ”版 

本 。 集 成 Persona 时 ， 本 可 以 使 用 真实 的 电子 邮件 地 址 。 撰 写本 章 初 稿 时 ， 我 实际 上 编 

于 < 个 坊 Yahoo.com， 然 后 使 用 我 注册 的 临时 账户 登录 。 这 么 做 有 个 问题 ， 
功能 测试 怎么 写 完 全 取决 于 Yahoo 的 电子 邮件 登录 界面 ， 而 这 个 界面 随时 可 能 变化 。 


使 用 MockMyID 或 Persona Test User 就 不 同 了 。 这 两 个 工具 在 Persona 的 文档 中 都 提 
到 过 ， 使 用 起 来 非常 顺畅 ， 因 此 我 们 只 需 测 试 集成 的 重要 部 分 


或 者 再 看 一 个 更 严重 的 问题 ， 支 付 系统 。 如 果 要 开始 整合 支付 ， 支 付 系统 会 成 为 网 站 
最 重要 的 部 分 之 一 ， 因 此 必须 充分 测试 。 但 你 并 不 想 每 次 运行 功能 测试 时 都 使 用 真实 
的 信用 卡 交 易 。 所 以 大 多 数 支付 服务 供应 商都 提供 了 测试 版 支付 API。 不 过 各 家 供应 
商 提供 的 测试 版 API 质量 参差 不 齐 (我 就 不 点 名 了 )， 所 以 一 定 要 仔细 研究 。 
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@ Mozilla Foundation (US) persona.org, 





EE 


By proceeding, you agree to Persona's localhost 


and 


ES Mozilla Persona. Simple sign-in from the non-proft behind Firefox. Le pre 一 


Netw 


Rules Computed Fonts Box Model 





the username and password must be in the dialog b.. ~|element { inline 


4<div id="authentication form” class="form section Laber :ud te Py dialog.css:1 | 
vcenter" style="width: 249px;"> 和 
b <div class="isMobile"></div> 
4<UL class="inputs"> 
b <div class="isDesktop"></div> 
4<Li> 
b<label cLass="hidden”for="authentication email" 





nargin-t p: Opx; 


></label> 

<input id="authentication email" 
class="isDesktopOrStart" type="email" 
placeholder="email address" maxlength="254" 
value="" spellcheck="false" autocorrect="off" ~ 











国共 9 








图 15-3; 使 用 调试 工具 条 找 出 定位 符 
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15.3.1 常用 Selenium 技 术 : 显 式 等 待 
实现 “等 待 ”功能 的 两 个 辅助 函数 之 一 如 下 所 示 : 





functional tests/test login.py (ch151014) 


import time 


[i 


def switch to new window(self, text in title): 
retries = 60 
while retries > 0: 
for handle in self.browser .window_handles: 
seLf .browser .switch_ to_window(handle) 
if text in title in self.browser.title: 
return 
retries -= 1 
time.sleep(0.5) 
self.fail('could not find window') 





也 


在 这 个 辅助 函数 中 ， 我 们 自己 动手 实现 等 待机 制 : 循环 访问 当前 打开 的 所 有 浏览 器 窗 
查找 有 指定 标题 的 那个 。 如 果 找 不 到 ， 稍 等 一 会 儿 再 试 ， 并 且 减 少 重 试 次 数 计数 器 。 


这 种 功能 在 Selenium 测试 中 经 常会 用 到 ， 因 此 开发 团队 创建 了 等 待 API。 不 过 这 个 API 无 
法 适用 于 所 有 情况 ， 所 以 才 在 这 个 辅助 函数 中 自己 动手 实现 等 待机 制 。 实 现 更 简单 的 等 待 
时 可 以 使 用 Webpriverwatt 类 ， 比 如 说 等 待 具有 指定 D 的 元 素 出 现在 页 面 中 ， 可 以 这 么 写 : 





























functional tests/test login.py (ch151015) 
from selenium.webdriver.support.ui import WebDriverWait 


[...] 


def wait for_element with id(self, element id): 
WebDriverWait(self.browser, timeout=30).until( 
Lambda b: b.find element by_id(element id) 


) 
这 就 是 Selenium 所 谓 的 “ 显 式 等 待 ”。 不 知 你 是 否 还 记得 ， 我 们 已 经 在 FunctionalTest. 
setUp 中 定义 了 一 个 “ 隐 式 等 待 "。 当 时 设 定 只 等 待 3 秒 ， 大 多 数 情况 下 这 段 时 间 已 经 够 用 
了 ， 但 等 待 Persona 等 外 部 服务 时 ， 有 时 要 延长 等 待 时 间 。 





Selenium 文 档 (http://docs.seleniumhq.org/docs/04_webdriver_advanced.jsp) 中 有 更 多 的 示 
例 ， 不 过 其 实 我 觉得 阅读 源码 (http://code.google.com/p/selenium/source/browse/py/selenium/ 
webdriver/support/wait.py) 更 直观 ， 因 为 代码 中 的 文档 字符 串 写 得 很 好 。 














implicitly_wait 并 不 可 靠 ， 尤 其 是 涉及 JavaScript 代码 时 。 如 果 功 能 测试 要 
检查 页 面 中 的 异步 交互 ， 最 好 使 用 wait_for_element_with_id 方法 中 的 方式 。 
第 20 章 会 再 次 见 到 这 种 用 法 。 























运行 这 个 功能 测试 会 发 现 ， 我 们 的 做 法 是 可 行 的 : 


$ python3 manage.py test functionaL_tests.test_Login 
Creating test database for alias 'default'... 

Not Found: /favicon.ico 

login view 

sending to mozilla {'assertion': [...] 

Ex] 

got b'{"audience":"localhost","expires":[...] 


[el 


Ran 1 test in 32.222s 
OK 
Destroying test database for alias 'default'... 




















你 其 至 还 会 看 到 我 探究 实现 视图 时 留 下 的 调试 信息 。 现 在 撤销 全 部 临时 改动 ， 使 用 测试 驱 
动 的 方式 一 步 步 重新 实现 。 
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15.3.2 ”删除 探究 代码 


$ git checkout master # 切换 到 master 分 支 

$ rm -rf accounts # 删除 所 有 探究 代码 

$ git add functional_tests/test_login.py 

$ git commit -m "FT for login with Persona" 














然后 再 次 运行 功能 测试 ， 让 它 驱 动 开 发 : 








$ python3 manage.py test functionaL_tests.test_Login 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"id","selector":"login"}' ; Stacktrace: 


Bd 


测试 首先 要 求 添 加 一 个 登录 链接 。 顺 便 说 一 下 ， 我 喜欢 在 HTML ID 前 加 上 id_。 这 是 一 种 
传统 做 法 ,便于 区 分 HTML 和 CSS 中 的 类 和 ID。 先 稍微 修改 一 下 功能 测试 .: 








functional tests/test login.py (ch151017) 


self.browser.find element_ by _id('id login').click() 
[...] 


self.wait for_element with id('id logout') 











然后 添加 一 个 没有 实际 作用 的 登录 链接 。Bootstrap 为 导航 条 提供 了 原生 的 类 ， 那 就 拿 来 用 吧 : 





lists/templates/base.html 


<div class="container"> 


<nav class="navbar navbar-default" role="navigation"> 
<a class="navbar-brand" href="/">Superlists</a> 























户 认证 、 集 成 第 三 方 插件 以 及 JavaScript 模 拟 技 术 的 使 用 | 241 


<a class="btn navbar-btn navbar-right" id="id_login" href="#">Sign in</a> 
</nav> 


<div class="row"> 


[...] 
等 待 30 秒 之 后 ， 测 试 输出 如 下 错误 : 


AssertionError: could not find window 





得 到 了 测试 的 授权 ， 可 以 进入 下 一 步 了 : 编写 更 多 的 JavaScript 代码 。 


15.4 涉及 外 部 组 件 的 JavaScript 单 元 测试 : 首次 
使 用 模拟 技术 


为 了 让 功能 测试 继续 向 下 运行 ， 需 要 弹出 Persona 窗口 。 为 此 ， 要 去 除 客 户 端 JavaScript 中 
的 探究 代码 ， 换 用 Persona 代码 库 。 在 这 个 过 程 中 ， 要 使 用 JavaScript 单元 测试 和 模拟 技术 
驱动 开发 。 


15.4.1 整理 : 全 站 共用 的 静态 文件 来 

首先 要 做 些 整理 工作 : 在 superlists/superlists 中 创建 一 个 全 站 共用 的 静态 文件 目录 ， 把 所 有 
Bootstrap 的 CSS 文件 、QUnit 代码 和 base.css 都 移 到 这 个 目录 中 。 移 动 之 后 应 用 的 文件 夹 
结构 如 下 所 示 : 
































$ tree superlists -L 3 -I _pycache__ 
superlists 

HFC _init_.py 

一 一 settings.py 

| 一 一 static 

| 一 一 base.css 

| 一 一 bootstrap 


nN 
a 
wm 


| 一 一 qunit.css 
上 -一 一 qunit.js 
一 urls.py 


wsgi.py 








6 directories, 7 files 


执行 这 种 整理 工作 前 后 一 定 要 提交 。 
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文件 位 置 变 了 ， 所 以 要 调整 现 有 的 JavaScript 单元 测试 


lists/static/tests/tests.html (ch151020) 
<link rel="stylesheet" href="../../../superlists/static/tests/qunit.css"> 


as] 

<script src="http://code.jquery.com/jquery.min.js"></script> 
<script src="../../../superlists/static/tests/qunit.js"></script> 
<script src="../list.js"></script> 


可 以 在 浏览 器 中 打开 这 些 单元 测试 ， 检 查 是 否 仍 能 正常 使 用 : 
2 assertions of 2 passed, 0 failed. 


我 们 要 在 设置 文件 中 指定 新 的 静态 文件 夹 地 址 ， 方 法 如 下 : 








superlists/settings.py 


STATIC_ROOT = os.path.join(BASE_DIR, '../static') 
STATICFILES_DIRS = ( 
os.path.join(BASE_DIR, 'superlists', 'static'), 


) 





我 建议 在 这 个 时 候 把 前 面 设 定 的 LOGGING 也 加 到 设置 文件 中 。 这 个 操作 不 用 
进行 具体 的 测试 ， 因 为 如 果 有 异常 ， 现 有 的 测试 组 件 会 告诉 我 们 。 在 第 17 
章 中 我 们 会 看 到 ， 这 个 设置 对 后 续 的 调试 很 有 用 。 





























然后 可 以 运行 布局 和 样式 的 功能 测试 ， 确 认 CSS 仍 能 正常 使 用 : 


$ python3 manage.py test functionaL_tests.test_Layout_and_styLing 


[...] 
OK 


接 下 来 创建 一 个 应 用 ， 命 名 为 accounts， 与 登录 相关 的 代码 都 放 在 这 个 应 用 中 ， 其 中 就 有 
Persona 的 JavaScript 代码 : 


$ python3 manage.py startapp accounts 
$ mkdir -p accounts/static/tests 


整理 工作 完成 了 。 现 在 是 提交 的 好 时 机 。 然 后 ， 我 们 再 看 一 下 探究 时 编写 的 JavaScript 
代码 : 





var loginLink = document.getElementById('login'); 
if (loginLink) { 
loginLink.onclick = function() { navigator.id.request(); }; 


} 
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15.4.2 ”什么 是 模拟 技术 ， 为 什么 要 模拟 ， 模 拟 什么 


要 把 登录 链接 的 onclick 事件 绑 定 到 Persona 代码 库 提供 的 navigator.id.request 国 数 上 。 


不 会 在 单元 测试 中 真 的 调用 第 三 方 函 数 ， 因 为 不 想 让 单元 测试 到 处 弹出 Persona 窗口 。 所 
以 要 使 用 模拟 技术 : 在 济 试 中 虚拟 或 者 模拟 实现 第 三 方 API。 


要 做 的 是 把 真正 的 navigator 对 象 替 换 成 一 个 我 们 自己 创建 的 虚拟 对 象 ， 这 个 虚拟 对 象 能 
告诉 我 们 发 生 了 什么 事 。 


Ml 

















我 本 来 希望 在 Python 代码 中 首次 演示 如 何 使 用 模拟 技术 ,但 看 样子 不 得 不 在 
JavaScript 代码 中 演示 了 。 读 完 本 章 后 ， 你 可 能 会 发 现 本 章 剩 下 的 内 容 要 多 
读 几 遍 才能 完全 理解 。 























15.4.3 命名 空间 

在 base.html 环境 中 ，navigator 只 是 全 局 作用 域 中 的 一 个 对 象 。 这 个 对 象 在 Mozilla 开 
发 的 Persona 代码 库 中 使 用 <script> 标签 引入 include.js 时 创建 。 测 试 全 局 变量 很 麻烦 ， 
所 以 可 以 把 navigator 传人 初始 化 “ 函数 , 创建 一 个 本 地 变量 。base.html 最 终 使 用 的 代码 
如 下 所 示 : 








lists/templates/base.html 


<script src="/static/accounts/accounts.js"></script> 
<script> 
$(document).ready(function() { 


Superlists.Accounts. initialize(navigator) 


}); 


</script> 


我 指定 把 initialize 国 数 放 在 多 层 肯 套 的 命名 空间 Superlists.Accounts 对 象 中 。JavaScript 的 名 
声 被 全 局 作用 域 这 种 编程 模式 搞 坏 了， 而 上 述 命名 空间 和 命名 习惯 有 助 于 缓解 这 种 局 面 。 很 多 
JavaScript 库 都 可 能 有 名 为 initiatize 的 函数 ， 但 很 少 会 有 Superlists.Accounts.initialize。” 


调用 initialize 函数 的 那 行 代码 很 简单 ， 无 需 任何 单元 测试 。 


























注 4: 我 把 “initialise” 拼 写成 “initialize”( 两 种 写法 都 是 “初始 化 ”的 意思 ) 可 能 会 让 说 英 式 英语 的 人 感到 恼怒 。 
我 知道 这 种 感受 ， 因 为 我 以 前 也 很 气愤 。 不 过 ， 在 代码 中 使 用 美式 拼写 的 习惯 越 来 越 为 世人 接受 。 如 
果 接 受 同一 种 拼写 方式 ,搜索 代码 和 协作 等 都 会 变 得 方便 。 在 这 方面 我 们 (本 书 作 者 是 英国 人 ,所 以 “我 
们 ” 代 指 说 英 式 英语 的 人 ) 是 少数 派 ， 接 受 现实 吧 ， 或许 我 们 在 这 场 斗 争 中 已 经 失败 了 。 

注 5: 在 JavaScript 中 ， 避 免 命名 空间 问题 的 内 亮 新 星 是 requirejs。requirejs 的 知识 点 很 多 ， 超 出 了 本 书 范畴 。 
不 过 你 应 该 研究 一 下 。 
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15.4.4 ”在 initialize 函 数 的 单元 测试 中 使 用 一 个 简单 的 驭 件 


initialize 图 数 本 身 需 要 测试 。 样 板 文件 HITML 从 清单 的 测试 复制 而 来 ， 然 后 修改 下 乓 
一 部 分 : 





























这 





accounts/static/tests/tests.html 


<div id="qunit-fixture"> 
<a id="id_ login">Sign in</a> 
</div> 


<script src="http://code.jquery.com/jquery.min.js"></script> 


<script src="../../../superlists/static/tests/qunit.js"></script> 
<script src="../accounts.js"></script> 
<script> 


/*global $, test, equal, sinon, Superlists */ 


test("initialize binds sign in button to navigator.id.request", function () { 

var requestWasCalled = false; //@ 
var mockRequestFunction = function () { requestWasCalled = true; }; //@ 
var mockNavigator = { //©@ 

id: { 

request: mockRequestFunction 

} 

}; 


Superlists.Accounts.initialize(mockNavigator); //@ 
$('#id login').trigger('click'); //© 


equal(requestWasCalled, true); //@ 
]); 


</script> 

理解 这 个 测试 ， 或 者 任何 测试 ， 最 好 的 方法 是 倒 着 看 。 我 们 从 断言 开始 看 。 

@ 断定 变量 requestWasCalled 的 值 为 true。 这 个 断言 检查 的 其 实 是 有 没有 像 在 navigator. 
id.request 中 一 样 调 用 request 国 数 。 

@ 什么 时 候 调 用 呢 ? id_logiin 元 素 上 发 生 点 击 事件 时 。 

@ 触发 点 击 事件 之 前 ， 像 在 真正 的 页 面 中 一 样 ， 调 用 Superlists.Accounts.initialize 国 


数 。 唯 一 的 区 别 在 于 ， 没 有 传人 Persona 提供 的 真正 全 局 navigator 对 象 ， 而 是 虚拟 的 
mockNavigator 对 象 “。 















































@ mockNavigator 其 实 就 是 一 个 普通 的 JavaScript 对 象 ， 有 个 名 为 id 的 属性 ， 其 值 也 是 一 
个 对 象 ， 在 这 个 对 象 中 有 个 名 为 request 的 属性 ， 其 值 是 mockRequestFunction 变量 。 

















注 6: 我 把 这 个 对 象 称 作 “ 驭 件 ”(mock)， 或 许 称 为 “ 侦 件 ”(spy) 更 贴切 。 在 这 本 书 中 不 必 纠 结 二 者 之 间 的 
区 别 ， 如 果 想 了 解 一 般 性 的 “测试 替身 ”工具 ， 以 及 桩 件 (stub)、 驭 件 、 伪 件 (fake) 和 侦 件 之 间 的 区 
别 ， 请 阅读 Emily Bache 写 的 Mocks, Fakes and Stubs 一 书 (https:Wleanpub.com/mocks-fakes-stubs ) 。 
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名 mockRequestFunction 是 个 简单 的 国 数 ， 调 用 时 会 把 requestWwasCalled 变量 的 值 简 单 地 
设 为 true。 





后 〈 或 者 说 首先 ? ) ， 确 保 requestWasCalled 的 初始 值 为 false。 





这 些 代码 的 最 终 目 的 是 ， 如 果 想 让 这 个 测试 通过 ， 只 有 一 种 方法 ， 即 initialize 函数 
要 把 id_Login 元 素 的 click 事件 绑 定 到 .id.request 方法 上 ， ee 
initialize 图 数 的 对 象 提供 。 如 果 使 用 驭 件 对 象 (mock object) 时 这 个 测试 能 ， 我 们 
就 相信 ， 在 真实 的 页 面 中 传人 真 正 的 对 象 时 ，initialize EE a 














理解 了 吗 ? 再 研究 一 下 这 个 测试 ， 看 你 能 否 理 解 。 











在 DOM 元 素 上 测试 事件 时 ， 需 要 有 一 个 真正 存在 的 元 素来 触发 事件 ， 还 要 
注册 监听 程序 。 如 果 你 忘记 添加 这 个 元 素 ， 测 试 会 出 错 ， 而 且 极 难 调试 ， 因 
为 .trigger 悄 无 声息 ， 不 会 报错 。 你 会 抓 耳 搁 腮 ， 想 知道 为 什么 测试 无 法 通 
过 。 所 以 ， 别 忘 了 在 id 为 qunit-fixture 的 div 中 添加 <div id="id_login"> 
元 素 。 



























































看 到 的 第 一 个 错误 是 


1. Died on test #1 
@file:///workspace/superlists/accounts/static/tests/tests.html:35: 
Superlists is not defined 


这 个 错误 和 Python 中 的 ImportError 是 一 个 意思 。 下 面 开 始 编写 accounts/static/accounts.js: 


accounts/static/accounts.js 


window.Superlists = null; 


就 像 在 Python 中 可 能 会 编写 Superlists = None 一 样 ， 在 JavaScript 中 可 以 写成 window. 
Superlists = nuLL; 。 使 用 window. 的 目的 是 ， 确 保 获 取 全 局 作用 域 中 的 对 象 ; 


1. Died on test #1 
@file:///workspace/superlists/accounts/static/tests/tests.html:35: 
Superlists is null 


好 的 ， 接 下 来 婴儿 学 步 ， 


accounts/static/accounts.js 


window.Superlists = { 
Accounts: {} 
}; 





测试 结果 为 “; 


Superlists.Accounts.initialize is not a function 


把 它 定 义 为 一 个 函数 : 
accounts/static/accounts.js 


window.Superlists = { 
Accounts: { 
initialize: function () {} 
} 
}; 
得 到 一 个 真正 的 测试 失败 的 消息 ， 而 不 仅仅 是 错误 : 


initialize binds sign in button to navigator.id.request (1, 0, 1) 





1. 


1. failed 
Expected: true 
Result: false 


接 下 来 ， 把 定义 initialize 函数 和 导入 命名 空间 Superlists 这 两 步 分 开 。 同 时 ， 还 要 使 用 
console.log (JavaScript 中 用 于 输出 调试 信息 的 方法 ) ， 看 看 是 哪个 对 象 调用 了 initialize 


函数 ; 
accounts/static/accounts.js (ch151028) 


var initialize = function (navigator) { 
console.log(navigator); 


}; 


window.Superlists = { 
Accounts: { 


initialize: initialize 


} 
}; 
在 Firefox (我 相信 Chrome 也 一 样 ) 中 可 以 使 用 快捷 键 Ctrl-Shift-I 调 出 JavaScript 终端 
在 终端 中 会 看 到 输出 了 [object Object (如 图 15-4) 。 点 击 输出 的 内 容 ， 你 会 看 到 在 测试 中 
定义 的 属性 : 一 个 id， 内 部 还 有 一 个 名 为 request 的 函数 。 

















用 域 中 已 经 有 window. 




















注 7: 在 实践 中 ， 设 定 这 种 命名 空间 时 ， 其 实 应 该 遵守 “添加 或 创建 ”模式 ， 如 果 作 
Superlists 对 象 ， 我 们 就 扩展 这 个 对 象 ， 而 不 是 替换 原 对 象 。witndow.SuperLists = window.Superlists 
1| 人 是 一 种 方式 ，jQuery 的 $.extend 是 另 一 种 方式 。 但 是 ， 本 章 的 内 容 已 经 够 多 了 ， 因 此 我 觉得 不 



































展开 细 说 或 许 更 好 。 
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3 
x - D % Javascript tests- Mozilla Firefox 


区 | 困 | : lin St... | 名 oOReily .| Test-Dri... [BTo-Do lists | E file...html |B compo... [8 jason xJa... XxX|? 中 


《 @ file:///home/harry/Dropbox/book/source/chapter_14/superlists/a -CC 图 jqueryextend Q 业 合 Hr 


Javascript tests 


Hide passed tests | Check for Globals OD No try-catch 


Mozilla15.0 (X11; Ubuntu; pA Firefox/124.0 





Tests completed in 48 milliseconds. 
0 assertions of 1 passed, 1 failed. 


Rerun 








1. failed 
Expected: tme 
Result: fatse 


Console specto Debugge Style Edit 


Net ~ Ess | BS Security ~  @Logging ~ 
961:11:95.458 object 0bject accountsjs:4 





vid: [object Object] 
v request: [object Function] 





N 
N 
» * prototype: [object Object] ;> 
其 Find: | Appendix ll 4 Previous *» Next Highlight all 力 Match case 
四 ”其 S) 曲 








15-4: 在 JavaScript 终端 里 调试 
现在 直接 让 测试 通过 : 


accounts/static/accounts.js (ch151029) 


var initialize = function (navigator) { 
navigator .id.request(); 


}; 





测试 是 通过 了 ， 但 这 不 是 我 们 想 要 的 实现 方式 。 我 们 一 直 在 调用 navigator .id.request， 
而 不 是 只 在 点 击 时 才 调用 ， 需 要 调整 测试 。 


1 assertions of 1 passed, 0 failed. 
1. initialize binds sign in button to navigator.id.request (0, 1, 1) 


调整 测试 之 前 ， 先 随便 改 改 代码 ， 看 是 否 真正 理解 了 我 们 在 做 什么 。 如 果 把 代码 改 成 下 面 
这 样 会 发 生 什么 事 呢 ? 








accounts/static/accounts.js (ch151029-1) 


var initialize = function (navigator) { 
navigator .id.request(); 
navigator .id.doSomethingElse(); 
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测试 的 结果 为 : 


1. Died on test #1 
@file:///workspace/superlists/accounts/static/tests/tests.html:35: 
navigator .id.doSomethingElse is not a function 


看 到 了 吧 ， 传 入 的 模拟 navigator 对 象 完 全 在 控制 之 中 。 这 个 对 象 只 拥有 被 赋予 的 属性 和 
方法 。 如 果 想 接着 改 ， 可 以 定义 这 个 方法 : 





accounts/static/tests/tests.html 
var mockNavigator = { 
id: { 
request: mockRequestFunction, 
doSomethingElse: function () { console.log("called me!");} 
} 
}; 


这 样 测试 就 通过 了 。 打 开 调 试 窗口 ， 会 看 到 如 下 输出 : 
[01:22:27.456] "called me!" 
调试 信息 是 不 是 有 助 于 你 理解 发 生 了 什么 事 ? 现在 撤销 最 近 的 两 次 改动 ， 然 后 修改 单元 测 


试 ， 确 保 request 函数 只 在 触发 点 击 事件 之 后 才 被 调用 。 还 要 添加 一 些 错误 消息 ， 以 便 找 
出 失败 的 是 两 个 equal 断言 中 哪个 失败 了 : 








accounts/static/tests/tests.html (ch151032) 


var mockNavigator = { 

id: { 

request: mockRequestFunction 

} 
}; 
Superlists.Accounts.initialize(mockNavigator); 
equal(requestWasCalled, false, 'check request not called before click'); 
$('#id login').trigger('click'); 
equal(requestWasCalled, true, 'check request called after click'); 








Oe 断言 的 消息 (equal 的 第 三 个 参数 ) 其 实 是 “成 功 ” 消 息 , 不 
管 测试 是 否 通过 都 会 显示 。 所 以 才 要 使 用 肯定 式 语句 。 





现在 失败 消息 更 明确 了 : 


1 assertions of 2 passed, 1 failed. 
1. initialize binds sign in button to navigator.id.request (1, 1, 2) 
1. check request not called before click 
Expected: false 
Result: true 




















二 
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二 


而 i 上 navigator .id.request 国 数 只 在 点 击 id_Login 之 后 才 调 用 : 


accounts/static/accounts.js (ch151033) 
/*global $ */ 


var initialize = function (navigator) { 
$('#id login').on('click', function () { 
navigator .id.request(); 


}); 


测试 通过 了 ， 这 是 个 好 的 开始 ! 在 模板 中 引入 这 个 文件 : 





lists/templates/base.html 


<script src="http://code.jquery.com/jquery.min.js"></script> 
<script src="https://\login.persona.org/include.js"></script> 
<script src="/static/accounts.js"></script> 
<script src="/static/list.js"></script> 
<script> 
/*global $, Superlists, navigator */ 
$(document).ready(function () { 
Superlists.Accounts.initialize(navigator); 
]); 
</script> 
</body> 


还 得 把 accounts 应 用 加 到 settings.py 中 ， 否 则 无 法 伺服 静态 文件 accounts/static/accounts.js: 


superlists/settings.py 


+++ b/superlists/settings.py 

QQ -37,4 +37,5 QQ INSTALLED APPS = ( 
'lists', 

+ "acCounts ' ， 


) 


然后 运行 功能 测试 …… 可 惜 训 无 进展 。 若 想 查 明 原 因 ， 可 以 手动 打开 网 站 ， 然 后 查看 
JavaScript 调试 终端 





[01:36:54.572] Error: navigator.id.watch must be called before 
navigator .id.request @ https://\login.persona.org/include.js:8 


15.4.5 ”高 级 模拟 技术 
现在 要 正确 调用 Mozilla 的 navigator.id.watch 函数 。 再 看 一 下 我 们 编写 的 探究 代码 ， 如 
下 所 示 : 

var currentUser = '{{ user.email }}' || null; 


var csrf_token = '{{ csrf_token }}'; 
console.log(currentUser); 





navigator .id.watch({ 
LoggedInUser: currentUser, //©@ 
onlogin: function(assertion) { 
$.post('/accounts/login', {assertion: assertion, csrfmiddlewaretoken: csrf_ 
token}) //@ 
.done(function() { window.Tlocation.reload(); }) 
.fail(function() { navigator.id.logout();}); 
入 
onlogout: function() { 
$.post('/accounts/logout') 
.always(function() { window.location.reload(); }); 


}); 
从 中 可 以 看 出 ，watch 函数 需要 从 爹 局 作用 域 中 获取 一 些 信 息 。 
@ 当前 用 户 的 电子 邮件 地 址 ， 作 为 loggedInUser 参数 传人 watch 国 数 。 








@ 当前 使 用 的 CSRF 令 牌 ， 传 和 发 往 登 录 视 图 的 Ajax POST 请 求 *。 
在 这 段 代码 中 还 硬 编码 了 两 个 URL， 这 两 个 URL 最 好 从 Django 中 获取 ， 方 法 如 下 : 





var urls = { 
Login: "{% url 'login' %}", 
logout: "{% url 'logout' %}", 
}; 


这 是 从 全 局 作用 域 中 传人 的 第 三 个 变量 。 已 经 定义 了 initialize 函数 ， 假 设 可 以 按照 下 古 
的 方式 调用 : 




















Superlists.Accounts.initialize(navigator, user, token, urls); 


使 用 sinon.js 创 建 驭 件 ， 确 认 调用 API 的 方式 是 否 正确 

正如 看 到 的 那样 ， 创 建 驭 件 是 可 能 的 。 实 际 上 ，JavaScript 更 是 将 其 变 得 相对 容易 ， 不 过 
使 用 驭 件 库 可 以 避免 很 多 党 复 的 操作 。JavaScript 领域 最 受 欢迎 的 驭 件 库 是 sinon.js。 下 载 
这 个 代码 库 (地 址 : http:/sinonjs.org) ， 把 它 放 到 全 站 共用 的 静态 汕 试 文件 夹 中 : 

















$ tree superlists/static/tests/ 
superlists/static/tests/ 


一 qunit.css 
一 qunit.js 


-一 sinon.js 


接 下 来 ， 在 账户 测试 中 引入 这 个 库 : 




















注 8: 顺便 说 一 下 ， 注 意 ， 我 们 使 用 {{ csrf_token }} 传令 牌 的 原始 字符 串 形式 ， 而 {% csrf_token%} 得 到 
的 是 完整 的 HTML 标签 ， 即 <input type="hidden" name=" etc etc。 





























户 认证 、 集 成 第 三 方 插件 以 及 JavaScript 模 拟 技 术 的 使 用 | 251 





accounts/static/tests/tests.html 


<script src="http://code.jquery.com/jquery.min.js"></script> 


<script src="../../../superlists/static/tests/qunit.js"></script> 
<script src="../../../superlists/static/tests/sinon.js"></script> 
<script src="../accounts.js"></script> 


现在 可 以 使 用 Sinon 提供 的 双 件 对 象 编写 测试 了 ”: 


accounts/static/tests/tests.html (ch151038) 


test("initialize calls navigator.id.watch", function () { 

Var User = "current user'; 
var token = 'csrf token ' ; 
var urls = {login: 'login url', logout: 'logout url'}; 
var mockNavigator = { 

id: { 

watch: sinon.mock() //©@ 

} 

}; 


Superlists.Accounts.initialize(mockNavigator, user, token, urls); 


equall 
mockNavigator .id.watch.calledOnce, //@ 
true, 
'check watch function called' 
); 
]); 


@ 和 之 前 一 样 ， 创 建 一 个 模拟 的 navigator 对 象 ， 不 过 这 一 次 没有 自己 动手 定义 函数 实现 
所 需 的 功能 ， 而 是 使 用 一 个 sinon.mock() 对 象 。 





@ 这 个 对 象 会 在 特殊 的 属性 〈 例 如 calledonce) 中 记录 发 生 了 什么 ， 在 断言 中 可 以 比较 这 
个 属性 的 值 。 











Sinon 文档 中 有 更 多 的 说 明 一 一 其 实 首 页 (http://sinonjs.org/) 的 功能 概览 写 得 就 不 错 。 
会 得 到 一 个 预期 的 失败 测试 : 
2 assertions of 3 passed, 1 failed. 
1. initialize binds sign in button to navigator.id.request (0, 2, 2) 
2. initialize calls navigator.id.watch (1, 0, 1) 
1. check watch function called 


Expected: true 
Result: false 


加 入 对 watch 函数 的 调用 : 








注 9: Sinon 还 专门 提供 了 侦 件 对 象 和 桩 件 对 象 。 不 过 双 件 能 实现 侦 件 和 桩 件 的 所 有 功能 ， 所 以 我 觉得 少 提 一 
些 术语 ， 别 把 事情 弄 得 这 么 复杂 比较 好 。 
































accounts/static/accounts.js 


var initialize = function (navigator) { 


}; 
但 这 么 
1 


1. 


$('#id login').on('click', function () { 
navigator .id.request(); 


的 


navigator .id.watch(); 


做 导致 另 一 个 测试 失败 了 : 


assertions of 2 passed, 1 failed. 


initialize binds sign in button to navigator.id.request (1, 0, 1) 
1. Died on test #1 


@file:///workspace/superlists/accounts/static/tests/tests.html:36: 
missing argument 1 when calling function navigator.id.watch 


2 


initialize calls navigator.id.watch (0, 1, 1) 


这 有 点 儿 费 解 一 一 我 花 了 很 长 时 间 才 和 弄 清 楚 “missing argument 1 when calling function 
navigator.id.watch” 是 什么 意思 。 原 来 在 Firefox 中 ， 每 个 对 象 都 有 .watch 国 数 (https:/ 
developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/watch)。 所 


以 在 前 


一 个 测试 中 也 要 创建 一 个 驭 件 : 


accounts/static/tests/tests.html 


test("initialize binds sign in button to navigator.id.request", function () { 


现在 测 


3 


1. 
2 


var requestWasCalled = false; 
var mockRequestFunction = function () { requestWasCalled = true; }; 
var mockNavigator = { 
id: { 
request: mockRequestFunction, 
watch: function () {} 


} 
}; 
[...] 
试 都 能 通过 了 : 


assertions of 3 passed, 0 failed. 


initialize binds sign in button to navigator.id.request (0, 2, 2) 
initialize calls navigator.id.watch (0, 1, 1) 


15.4.6 ”检查 参数 的 调用 


调用 watch 函数 的 方法 还 不 正确 





几 个 回 








watch 函数 要 知道 当前 用 户 ， 还 要 为 登录 和 退出 定义 
调 函 数 。 先 解决 当前 用 户 : 
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accounts/static/tests/tests.html (ch151042) 


test("watch sees current user", function () { 

Var User = "current user'; 
var token = 'csrf token'; 
var urls = {login: 'login url', logout: 'logout url'}; 
var mockNavigator = { 

id: { 

watch: sinon.mock() 

} 

}; 


Superlists.Accounts.initialize(mockNavigator, user, token, urls); 
var watchCallArgs = mockNavigator.id.watch.firstCall.args[0]; 
equal(watchCallArgs.loggedInUser, user, 'check user'); 


}); 
编写 代码 的 方式 与 前 面 类 似 (不 小 心 让 代码 异味 了 ， 下 一 节 我 们 要 删除 重复 的 测试 代码 )。 
在 驭 件 上 调用 .firstcall.args[0]， 获 取 传 入 watch 函数 的 参数 (args 是 由 位 置 参数 组 成 
的 列表 )。 测 试 结果 如 下 : 








3. watch sees current user (1, 0, 1) 

1. Died on test #1 
@file:///workspace/superlists/accounts/static/tests/tests.html:72: 
watchCallArgs is undefined 


这 是 因为 还 没有 向 watch 函数 传 入 任何 参数 。 一 步 步 来 解决 : 


accounts/static/accounts.js (ch151043) 
navigator .id.watch({}); 


错误 消息 变 得 更 明确 了 : 
3. watch sees current user (1, 0, 1) 
1. check user 


Expected: "current user" 
Result: undefined 


那 就 解决 这 个 问题 吧 ， 


accounts/static/accounts.js (ch151044) 


var initialize = function (navigator, user, token, urls) { 


Li] 


navigator .id.watch({ 
loggedInUser: user 


}); 
大 好 了 ， 测 试 全 部 通过 了 : 


4 assertions of 4 passed, 0 failed. 





15.4.7 ”QUnit 中 的 setup 和 teardown 函 数 ， 0 
接 下 来 检查 onLogin 回调 函数 。 当 Persona 有 用 户 认证 信息 要 发 给 服务 器 验证 时 ， 该 回调 
函数 会 被 调用 。 这 个 过 程 涉及 Ajax 调用 ($.post)， 一般 来 说 很 难 测 试 ， sinon.js 提供 
了 一 个 辅助 的 虚拟 XMLHttpRequest 服务 器 (http://sinonjs.org/docs/#server) 。 

















个 对 象 暂 时 屏蔽 了 JavaScript 中 原生 的 XMLHttpRequest 类 ， 所 以 测试 完毕 后 确认 甚 是 否 
0 个 好 习惯 。 代 此 机 会 ， 学 习 QUnit 中 的 setup 和 teardown 方法 ， 这 两 个 方法 都 用 于 
module 国 数 中 。modutLe 函数 有 点 儿 类 似 于 unittest.TestCase 类 ， 其 作用 是 把 随后 的 所 有 
测试 归 类 到 一 起 。 





























关于 Ajax 
如 果 你 此 前 从 未 用 过 Ajax， 下 面 做 个 简要 介绍 。 不 过 ， 读 过 这 个 简介 之 后 最 好 再 找 其 
他 资料 仔细 研究 。 
Ajax 是 “Asynchronous JavaScript and XML”( 异步 JavaScript 和 XML) 的 简称 ， 不 
过 “XML” 有 点 表述 不 当 ， 因 为 现在 基本 上 都 使 用 纯 文 本 或 JSON。 使 用 Ajax 技术 可 
以 在 客户 闹 JavaScript 代码 中 通过 HTTP 协议 (GET 和 POST 请 求 ) 收发 数据 ， 而 且 
“异步 ”完成 ， 既 没有 阻塞 ， 也 不 用 重新 加 载 页 面 。 


这 里 要 使 用 Ajax 技术 向 登录 视图 发 起 POST 请求， 发 送 Persona 获取 的 判定 数据 。 我 
们 会 使 用 jQuery 提供 的 Ajax 辅助 函数 (http://api.jquery.com/jQuery.post/) 。 











在 第 一 个 测试 之 后 、 测 试 "initialize calls navigator.id.watch" 之 前 加 入 module 国 数 ; 





accounts/static/tests/tests.html (ch151045) 


var user, token, urls, mockNavigator, requests, xhr; //@ 
module("navigator.id.watch tests", { 
setup: function () { 
user = 'current user'; //@ 
token = 'csrf token'; 
urls = { login: 'login url', logout: 'logout url' }; 
mockNavigator = { 
id: { 
watch: sinon.mock() 
} 
}; 
xhr = sinon.useFakeXMLHttpRequest(); //©@ 
requests = []; //@ 
xhr.onCreate = function (request) { requests.push(request); }; //© 
]， 
teardown: function () { 
mockNavigator .id.watch.reset(); //@ 
xhr.restore(); //@ 


}); 
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test("initialize calls navigator.id.watch", function () { 


[...] 


@ 把 user、token、urls 等 变量 放 在 外 层 作 用 域 中 ， 这 样 它们 才能 用 于 该 文件 中 的 所 有 
测试 。 











@ 前 setup 函数 中 的 变量 就 像 unittest 中 的 setup 函数 一 样 ， 会 在 每 个 测试 之 
前 初始 化 。 这 些 变量 中 包含 nockNavigator。 


























日 “在 setup 函数 中 ， 还 调用 了 Sinon 提供 的 useFakeXMLHttpRequest 函数 ， 和 暂时 屏蔽 浏览 
器 对 Ajax 的 支持 。 





@ © 还 有 一 点 儿 样 板 代 码 : 告诉 Sinon， 把 所 有 Ajax 请 求 都 保存 到 requests 数组 中 ， 以 
便 在 测试 中 使 用 。 


@ ”最 后 ， 要 做 些 清理 工作 一 一 在 两 次 测试 之 间 还 原 watch 驭 件 〈 和 否则 ， 在 某 次 测试 中 的 
调用 结果 会 显示 在 另 一 个 测试 中 )。 








@ 然后 把 JavaScript 中 的 XMLHttpRequest 还 原 到 初始 状态 。 





这 样 就 可 以 使 用 更 少 的 代码 重 写 前 面 两 个 测试 了 : 














accounts/static/tests/tests.html (ch151046) 


test("initialize calls navigator.id.watch", function () { 
Superlists.Accounts.initialize(mockNavigator, user, token, urls); 
equal(mockNavigator .id.watch.calledOnce, true, 'check watch function called'); 


}); 


test("watch sees current user", function () { 
Superlists.Accounts.initialize(mockNavigator, user, token, urls); 
var watchCallArgs = mockNavigator.id.watch.firstCall.args[0]; 
equal(watchCallArgs.loggedInUser, user, 'check user'); 


}); 
测试 仍 能 通过 ， 不 过 测试 名 称 前 面 加 上 了 模块 名 : 
4 assertions of 4 passed, 0 failed. 
1. initialize binds sign in button to navigator.id.request (0, 2, 2) 


2. navigator.id.watch tests: initialize calls navigator.id.watch (0, 1, 1) 
3. navigator.id.watch tests: watch sees current user (0, 1, 1) 


onlogin 回调 函数 的 测试 方法 如 下 : 


accounts/static/tests/tests.html (ch151047) 


test("onlogin does ajax post to login url", function () { 





Superlists.Accounts.initialize(mockNavigator, user, token, urls); 

var onloginCallback = mockNavigator.id.watch.firstCall.args[0].onlogin; //© 
onloginCallback(); //@ 

equal(requests.length, 1, 'check ajax request'); //© 
equal(requests[0].method, 'POST'); 

equal(requests[0].url, urls.login, 'check url'); 


}); 


test("onlogin sends assertion with csrf token", function () { 
Superlists.Accounts.initialize(mockNavigator, user, token, urls); 
var onloginCallback = mockNavigator.id.watch.firstCall.args[0].onlogin; 


var assertion = 'browser-id assertion ' ; 
onloginCallback(assertion); 
equall 


requests[0].requestBody, 
$.param({ assertion: assertion, csrfmiddlewaretoken: token }), //@ 
'check POST data' 
); 
]); 


@ 从 navigator 模拟 对 象 的 watch 双 件 中 可 以 提取 出 我 们 定义 的 ontlogin 回调 函数 。 








@ 为 了 测试 这 个 回调 函数 ， 可 以 直接 调用 它 。 











@ Sinon 中 的 fakeXMLHttpRequest 服务 器 会 捕获 我 们 发 出 的 任意 Ajax 请 求 ， 并 把 它们 存 入 
requests 数组 。 然 后 可 以 检查 很 多 信息 ， 例 如 是 否 为 POST 请 求 ， 或 者 请 求 的 是 哪个 URL。 











@ POST 请 求 真正 发 送 的 参数 保存 在 .requestBody 中 ， 而 且 被 URL 编码 了 (使 用 
&key=val 的 语法 形式 )。jQuery 提供 的 $.paran 函数 可 以 进行 URL 编码 ， 所 以 对 比 时 调 
用 了 这 个 函数 。 


这 两 个 测试 和 预期 一 样 ， 失 败 了 : 











4. navigator .id.watch tests: onlogin does ajax post to login url (1, 0, 1) 

1. Died on test #1 
@file:///workspace/superlists/accounts/static/tests/tests.html:78: 
onloginCallback is not a function 


5. navigator.id.watch tests: onLogin sends assertion with csrf token (1, 0, 1) 

1. Died on test #1 
@file:///workspace/superlists/accounts/static/tests/tests.html:90: 
onloginCallback is not a function 

















又 要 经 历 一 次 “单元 测试 /编写 代码 ”循环 。 在 此 次 循环 中 ， 我 看 到 的 测试 结果 按照 下 面 
的 顺序 变化 : 








1. check ajax request 
Expected: 1 
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3. check url 
Expected: "login url" 


变 成 : 


7 assertions of 8 passed, 1 failed. 
1. check POST data 
Expected: 


"assertion=browser-id+tassertion&csrfmiddlewaretoken=csrf+token" 
Result: null 


变 成 : 


1. check POST data 
Expected: 


"assertion=browser-id+tassertion&csrfmiddlewaretoken=csrf+token" 
Result: "assertion=browser-id+assertion" 


变 成 : 
8 assertions of 8 passed，0 failed. 


最 终 写 出 的 代码 如 下 : 


accounts/static/accounts.]js 
navigator .id.watch({ 
loggedInUser: user, 
onlogin: function (assertion) { 
$.post( 
urls.login, 
{ assertion: assertion, csrfmiddlewaretoken: token } 


)3 
}); 
退出 
在 写作 本 书 时 ，Persona 监视 API 状态 的 “onlogout” 部 分 还 未 定型 。 它 虽然 可 以 使 用 ， 但 
不 能 满足 我 们 的 需求 。 所 以 我 们 只 是 把 它 编写 成 一 个 空 国 数 ， 并 将 其 当 作 一 个 占 位 符 。 最 
简单 的 测试 如 下 : 

















accounts/static/tests/tests.html (ch151053) 


test("onlogout is just a placeholder", function () { 
Superlists.Accounts.initialize(mockNavigator, user, token, urls); 
var onlogoutCallback = mockNavigator.id.watch.firstCall.args[0].onlogout; 
equal(typeof onlogoutCallback, "function", "onlogout should be a function"); 


}); 


I 





得 到 的 退出 函数 十 分 简单 ， 








accounts/static/accounts.js (ch151054) 


]， 
onlogout: function () {} 


}); 


15.4.8 深层 能 套 回调 函数 和 测试 异步 代码 
回调 在 套 是 JavaScript 的 精髓 。 幸 好 sinon.js 对 此 提供 了 帮助 。 还 需要 测试 登录 时 调用 的 
post 方法 ， 也 设置 了 一 些 回 调 函 数 ， 在 POST 请 求 的 结果 返回 之 后 做 些 处 理工 作 : 








.done(function() { window.location.reload(); }) 
.fail(function() { navigator.id.logout();}); 





我 不 会 测试 window.1location.reload， 因 为 这 有 点 儿 过 于 复杂 了 "， 而 且 我 觉得 可 以 在 
Selenium 测试 中 测试 。 不 过 我 们 要 测试 fail 回调 函数 ， 以 此 演示 舱 套 回调 也 能 测试 : 
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test("onlogin post failure should do navigator.id.logout ", function () { 
mockNavigator .id.logout = sinon.mock(); //©@ 
Superlists.Accounts.initialize(mockNavigator, user, token, urls); 
var onloginCallback = mockNavigator.id.watch.firstCall.args[0].onlogin; 
var server = sinon.fakeServer.create(); //@ 
server.respondWith([403, {}, "permission denied"]); //©@ 


onloginCallback(); 
equal(mockNavigator .id.logout.called, false, 'should not logout yet'); 


server.respond(); //@ 
equal(mockNavigator .id.logout.called, true, 'should call logout'); 
]); 


@ 为 需要 测试 的 mockNavigator .id.logout 函数 创建 一 个 驭 件 。 


@ 使 用 Sinon 提供 的 fakeServer。 这 是 建立 在 fakeXMLHttpRequest 之 上 的 一 个 抽象 对 象 ， 
用 来 模拟 Ajax 服务 器 的 响应 。 


@ 让 虚拟 服务 器 返回 403“permission denied” 响 应 ， 以 此 模拟 用 户 未 授权 时 的 状态 。 
@ 然后 ， 让 虚拟 服务 器 发 送 响 应 。 因 为 只 有 了 响应 发 出 后 才 会 调用 Logout 函数 。 
根据 这 个 测试 ， 要 稍微 修改 一 下 探究 代码 : 























accounts/static/accounts.js (ch151056) 


onlogin: function (assertion) { 
$.post( 
urls. login, 
{ assertion: assertion, csrfmiddlewaretoken: token } 





主 10: 我 们 无 法 模拟 window.location.reload, 所 以 要 定义 一 个 未 经 测试 的 Superlists.Accounts.refreshPage 
函数 , 然后 在 测试 中 创建 一 个 驭 件 模拟 refreshPage 函数 , 检查 它 是 否 被 设 为 Ajax 调用 的 .done 回调 。 


一 
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).fail(function () { navigator .id.Logout(); }); 
]， 
onlogout: function () {} 








最 后 ， 再 添加 window.location.reload。 这 么 做 只 是 为 了 确认 它 不 会 导致 任何 一 个 单元 测 
试 失败 : 





accounts/static/accounts.js (ch151057) 
navigator .id.watch({ 
loggedInUser: user, 
onlogin: function (assertion) { 
$.post( 
urls.login, 
{ assertion: assertion, csrfmiddlewaretoken: token } 


) 
.done(function () { window.location.reload(); }) 
.fail(function () { navigator.id.logout(); }); 
二 
onLogout: function () {} 
]); 
一 切 仍然 正常 : 


11 assertions of 11 passed, 0 failed. 





























如 果 你 觉得 把 .done 和 .fail 串 在 一 起 让 人 困惑 (我 觉得 有 点 儿 )， 可 以 使 用 其 他 写法 ， 例 如 : 








var deferred = $.post( 
urls. login, 
{ assertion: assertion, csrfmiddlewaretoken: token } 


a et () { window.location.reload(); }) 

deferred.fail(function () { navigator.id.logout(); }); 
异步 代码 总 是 这 样 ， 让 人 难以 理解 。 不 过 我 觉得 串 在 一 起 读 起 来 更 顺口 :“ 上 向 urls.login 
发 起 POST 请 求 ， 并 把 判定 数据 和 CSRF 令 牌 传 给 这 个 视图 ， 请 求 处 理 完 成 之 后 ， 重 新 加 
载 页 面 ， 如 果 请 求 失败 ， 执 行 navigator.id.logout 函数 。 你 可 以 阅读 这 篇 文章 (http:// 
otaqui.com/blog/1637/introducing-javascript-promises-aka-futures-in-google-chrome-canary/) 


研究 一 下 JavaScript 中 的 deferred 对 象 ( 也 叫 “promise” )。 






































关键 时 刻 到 了 : 功能 测试 还 能 更 进一步 吗 ? 先 调整 一 下 对 initialize 函数 的 调用 : 





lists/templates/base.html 
<script> 

/*global $, Superlists, navigator */ 
$(document).ready(function () { 

var user = "{{ user.email }}" || null; 

var token = "{{ csrf_token }}"; 

var urls = { 

Login: "TODO", 








Logout : "TODO", 


]3 
Superlists.Accounts.initialize(navigator, user, token, urls); 
]); 
</script> 
然后 运行 功能 测试 : 


$ python3 manage.py test functionaL_tests.test_Login 
Creating test database for alias 'default'... 

Not Found: /favicon.ico 

Not Found: /TODO 


Traceback (most recent call last): 
File "/workspace/superlists/functional_tests/test_login.py", line 47, in 
test_login with_persona 
self.wait for_element with id('id_ logout') 
File "/workspace/superlists/functional_ tests/test_login.py", line 23, in 
wait_ for_element with id 
Lambda b: b.find element_ by_id(element_id) 
Ez] 


selenium.common.exceptions.TimeoutException: Message: 


Ran 1 test in 28.779s 


FAILED (errors=1) 
Destroying test database for alias 'default'... 








太 棒 了 ! 我 知道 测试 失败 了 ， 但 看 到 弹出 了 Persona 对 话 框 ， 而 且 后 面 的 操作 也 都 完成 了 。 
将 在 下 一 章 介绍 服务 器 端 认证 。 

















关于 在 JavaScript 中 探究 和 使 用 模拟 技术 
探究 


探索 性 编程 ， 找 到 新 API 0 a sa 探 完 时 可 以 不 写 


测试 。 最 好 在 新 分 支 中 探 完 ， 删 完 代码 后 再 回 到 主 分 支 。 


模拟 技术 
编写 单元 测试 时 ， 如 果 涉 及 第 三 方 服务 ， 但 又 不 想 在 测试 中 真 的 使 用 这 项 服务 ， 


可 以 使 用 模拟 技术 。 了 驭 件 用 来 模拟 第 三 方 API。 虽 然 可 以 在 JavaScript 中 自己 创 
驭 件 ， 但 模拟 框架 (例如 Sinon) 可 以 提供 很 多 便利 ， 让 编写 测试 变 得 更 简单 ， 更 


重要 的 是 ， 测 试 读 起 来 更 顺口 。 





Ajax 请 求 的 单元 测试 
Sinon 能 给 予 很 大 帮助 。 自 己 动手 模拟 Ajax 请 求 真 的 很 痛苦 。 
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第 16 章 
服务 器 端 认证 ， 在 Python 中 
使 用 模拟 技术 











再 接 再 厉 ， 这 一 章 我 们 实现 新 认证 系统 的 服务 器 端 代码 。 我 们 将 在 本 章 使 用 更 多 模拟 技 
术 ， 不 过 这 一 次 是 用 于 Python 代码 中 。 我 们 还 要 学 习 如 何 定制 Django 的 认证 系统 。 
16.1 探究 登录 视图 


在 上 一 章 末 尾 ， 我 们 写 好 了 可 以 使 用 的 客户 端 代码 ， 尝 试 把 认证 判定 数据 发 给 服务 器 中 的 
登录 视图 。 下 面 我 们 开始 编写 这 个 视图 ， 然 后 再 创建 后 台 认 证 函数 。 
































探究 时 编写 的 登录 视图 如 下 所 示 : 


def persona_Login(request ) : 
print('login view', file=sys.stderr) 
#user = PersonaAuthenticationBackend().authenticate(request.POST['assertion']) 
user = authenticate(assertion=request.POST['assertion']) #0 
if user is not None: 
login(request, user) #@ 
return redirect('/') 


@ authenticate 是 我 们 自 定义 的 认证 函数 ， 稍 后 定义 。 这 个 函数 的 作用 是 验证 客户 端 发 送 
的 判定 数据 。 

@ login 是 Django 原生 的 登录 国 数 。 它 把 一 个 会 话 对 象 存储 到 服务 器 中 ， 并 且 和 用 户 的 
cookie 关联 起 来 ， 这 样 在 以 后 的 请 求 中 我 们 就 知道 这 个 用 户 已 经 通过 认证 。 
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authenticate 函数 要 通过 互联 网 访问 Mozilla 的 服务 器 。 在 单元 测试 中 我 们 可 不 想 这 么 做 ， 
所 以 要 模拟 authenticate 国 数 的 功能 。 


16.2 ”在 Python 代码 中 使 用 模拟 技术 


流行 的 mock 包 已 经 集成 到 Python 3.3 中 。' 这 个 包 提 供 了 一 个 神奇 的 对 象 Nock， 有 点 像 上 
一 章 用 过 的 Sinon 驭 件 对 象 ， 不 过 功能 更 强大 。 下 面试 用 一 下 : 





>>> from unittest.mock import Mock 

>>> m = Mock() 

>>> m.any_attribute 

<Mock name='mock.any_attribute' id='140716305179152'> 
>>> m.foo 

<Mock name='mock.foo' id='140716297764112 ' > 

>>> m.any_method() 

<Mock name='mock.any_method()' id='140716331211856'> 
>>> m.foo() 

<Mock name='mock.foo()' id='140716331251600'> 

>>> m.called 

False 

>>> m.foo.called 

True 

>>> m.bar.return_value = 1 

>>> m.bar() 

1 


使 用 驭 件 对 象 模拟 authenticate 函数 的 功能 应 该 很 灵巧 。 下 


16.2.1 通过 模拟 authenticate 函 数 测 试 视图 
(我 相信 你 知道 怎么 创建 tests 文件 来， 也 知道 要 加 入 __init _.py 文 从 
tests.py 文件 。) 





而 介绍 如 何 模拟 。 











I 








。 别 忘 了 删除 默认 的 


I 





accounts/tests/test_views.py 


from django.test import TestCase 
from unittest.mock import patch 


class LoginViewTest(TestCase): 


@patch('accounts.views.authenticate') #@ 

def test calls_authenticate with assertion from post( 
self, mock_authenticate #@ 

) 
mock_authenticate.return_vaLue = None #@ 
self.client.post('/accounts/login', {'assertion': 'assert this'}) 
mock_authenticate.assert _ called once with(assertion='assert this') #@ 

















注 1: 如 果 你 还 在 使 用 Python 3.2, 升级 吧 ! 如 果 你 坚持 要 使 用 这 个 版 本 , 执行 命令 pip3 install mock 安装 ， 
把 后 文中 出 现 的 from unittest.mock 换 成 from mock。 
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@ patch 修饰 符 有 点 儿 像 上 一 章 Sinon 中 的 mock 函数 ， 作 用 是 指定 要 模拟 的 对 象 。 这 里 我 


们 要 模拟 的 是 我 们 希望 在 accounts/views.py 中 使 用 的 authenticate 函数 。 





@ 修饰 符 把 模拟 对 象 作 为 额外 的 参数 传人 被 应 用 的 函数 中 。 
@ 然后 我 们 可 以 配置 这 个 驭 件 ， 让 它 具 有 特定 的 行为 。 让 authenticate 国 数 返 





回 None 是 





最 简单 的 行为 ， 所 以 我 们 设 定 了 特殊 的 .return_value 属性 。 否 则 ， 这 个 驭 件 会 返回 另 























一 个 双 件 ， 视 图 可 能 不 知道 怎么 处 理 。 











@ 驭 件 可 以 作出 断言 ! 在 本 例 中 ， 我 们 检查 驭 件 是 否 被 调用 ， 以 及 调用 时 传 入 的 参数 是 什么 。 




















测试 的 结果 如 何 呢 ? 


$ python3 manage.py test accounts 

| ee 

AttributeError: <module 'accounts.views' from 

' /workspace/superlists/accounts/views.py'> does not have the attribute 
'authenticate' 


我 们 试图 模拟 的 函数 还 不 存在 ， 需 要 把 authenticate 函数 导入 views.py: ” 





accounts/views.py 


from django.contrib.auth import authenticate 

















现在 测试 的 结果 是 : 


AssertionError: Expected 'authenticate' to be called once. Called 0 times. 


这 个 失败 在 预料 之 中 。 我 们 要 把 登录 视图 和 一 个 URL 联系 起 来 : 


superlists/urls.py 
urlpatterns = patterns('', 
url(r'^$', 'lists.views.home page', name='home'), 
url(r'^lists/', include('lists.urls')), 
url(r'^accounts/', include('accounts.urls')), 
# url(r'^admin/', include(admin.site.urls)), 
) 
accounts/urls.py 


from django.conf.urls import patterns, url 


urlpatterns = patterns('', 


url(r'^login$', 'accounts.views.persona_login', name='persona_login'), 


) 





注 2: 虽然 我 们 要 自己 定义 authenticate 畏 数 ， 不 过 还 是 要 从 django.contrib.auth 中 导入 。 




















第 三 方 库 代 禁 authenticate 函数 ， 无 需 修改 views.py。 





只 要 我 们 在 
settings.py 中 配置 好 ，Django 就 会 自动 换 用 我 们 自己 定义 的 函数 。 这 么 做 有 个 好 处 ， 如 果 以 后 要 使 用 

















| 


编写 一 个 最 简单 的 视 





有 没有 用 呢 ? 











accounts/views.py 
from django.contrib.auth import authenticate 


def persona_login(): 
pass 


确实 有 用 : 
TypeError: persona_login() takes 0 positional arguments but 1 was given 


继续 编写 视图 : 





accounts/views.py (ch161008) 


def persona_login(request): 





pass 
这 次 测试 的 结果 为 : 


ValueError: The view accounts.views.persona_login didn't return an HttpResponse 
object. It returned None instead. 


accounts/views.py (ch161009) 


from django.contrib.auth import authenticate 
from django.http import HttpResponse 


def persona_login(request): 
return HttpResponse() 


测试 结果 又 变 成 了 : 


AssertionError: Expected 'authenticate' to be called once. Called 0 times . 








把 视图 写成 下 了 








这 样 试 试 ; 














accounts/views.py 
def persona_login(request): 
authenticate() 
return HttpResponse() 


显然 会 得 到 以 下 结果 : 


AssertionError: Expected call: authenticate(assertion='assert this') 
Actual call: authenticate() 


这 个 问题 我 们 也 能 解决 : 

















| 
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accounts/views.py 


def persona_login(request): 
authenticate(assertion=request.POST['assertion']) 
return HttpResponse() 


到 目前 为 止 一 切 顺利 。 我 们 模拟 并 测试 了 一 个 Python 函数 。 


16.2.2 确认 视图 确实 登录 了 用 户 

但 是 ， 如 果 authenticate 函数 返回 一 个 用 户 ，authenticate 视图 也 要 通过 a us ed 
auth.Login 函数 ， 让 用 户 真 正 登 录 网 站 。 所 以 authenticate 函数 不 能 返回 2 
个 视图 处 理 的 是 Ajax 请 求 ， 那 么 就 无 需 返回 HTML， 返 回 一 个 简单 的 "Oe sms 





























accounts/tests/test views.py (ch161011) 


from django.contrib.auth import get user_model 
from django.test import TestCase 

from unittest.mock import patch 

User = get_user_modeL() #0 


class LoginViewTest(TestCase): 
@patch('accounts.views.authenticate') 
def test calls authenticate with assertion from post( 


[0 


@patch('accounts.views.authenticate') 

def test_returns_OK_when_user_found( 
self, mock_authenticate 
User = User.objects.create(email='a@b.com') 
user.backend = '' # 为 了 使 用 auth.Login, 必 须 设 定 这 个 属性 
mock_authenticate.return_vaLue = user 
response = self.client.post('/accounts/login', {'assertion': 'a'}) 
self.assertEqual(response.content.decode(), 'OK') 








@ 我 要 说 明 一 下 django.contrib.auth 模块 中 的 get_user_model 函数 的 用 法 。 这 个 函数 的 
作用 是 找 出 项 目 使 用 的 用 户 模型 ， 不 管 是 标准 的 用 户 模型 还 是 自 定义 的 模型 (后面 就 要 
自 定义 ) 都 能 使 用 。 


























这 个 测试 检查 的 是 想得到 的 响应 。 下 面 我 们 要 测试 用 户 确实 正确 登录 了 。 我 们 使 用 的 方法 
是 检查 Django 测试 客户 端 ， 看 它 是 否 正确 设 定 了 会 话 cookie。 





现在 请 阅读 Django 文档 对 认证 的 说 明 (https://docs.djangoproject.com/en/1.7/ 
topics/auth/default/#how-to-log-a-user-in ) 。 








accounts/tests/test_views.py (ch161012) 


from django.contrib.auth import get user_model, SESSION KEY 
| | 


@patch('accounts.views.authenticate') 
def test gets_ logged in session if _ authenticate_ returns_a_user( 
self, mock_authenticate 





): 
User = User .objects.create(email='a@b.com') 
user.backend = '' # 为 了 使 用 auth.Login, 必 须 设 定 这 个 属性 
mock_authenticate.return_vaLue = User 
self.client.post('/accounts/login', {'assertion': 'a'}) 


self.assertEqual(self.client.session[SESSION_KEY], user.pk) #©| 


@patch('accounts.views.authenticate') 

def test does not get logged in if authenticate_returns_None( 
self, mock_authenticate 

): 
mock_authenticate.return_value = None 
self.client.post('/accounts/login', {'assertion': 'a'}) 
self.assertNotIn(SESSION_KEY, self.client.session) #@ 


@ Django 测试 客户 端 会 记录 用 户 的 会 话 。 为 了 确认 用 户 是 否 通过 验证 ， 我 们 要 检查 用 户 
的 ID (主键 ,简称 pk) 是 否 和 会 话 关联 在 一 起 。 





@ 如 果 用 户 没 有 通过 认证 ， 会 话 中 就 不 应 该 包含 SESSION_KEY。 





Django 会 话 : 用 户 的 cookie 如 何 告诉 服务 器 她 已 经 通过 认证 
我 试 着 向 你 解释 什么 是 会 话 、cookie， 以 及 在 Django 中 怎么 认证 用 户 。 
HTTP 是 无 状态 的 ， 因 此 服务 器 需要 一 种 在 每 次 请 求 中 识别 不 同 的 客户 闹 的 方法 。 卫 
地 址 可 以 共用 ， 所 以 一 般 使 用 的 方法 是 为 每 个 客户 田 指 定 一 个 唯一 的 会 话 ID。 会 话 
ID 存储 在 cookie 中 ， 每 次 请 求 都 会 提交 给 服务 器 。 服 务 器 在 某 处 存储 会 话 ID (默认 
情况 下 存 入 数据 库 ) ， 这 样 它 就 知道 各 个 请 求 来 自 哪个 特定 的 客户 病 。 
使 用 开发 服务 器 登录 网 站 时 ， 如 果 需 要 ， 其 实 可 以 手动 查看 自己 的 会 话 ID。 默 认 情况 
下 ,会 话 ID 存储 在 sessionid 键 下 ， 如 图 16-1 所 示 。 
不 管用 户 是 否 登 录 ， 只 要 访问 使 用 Django 开发 的 网 站 ， 就 会 为 访问 者 设 定 会 话 cookie。 
如 果 网 站 以 后 需要 识别 已 经 登录 且 通 过 认证 的 客户 端 ， 不 用 要 求 客 户 靖 在 每 次 请 求 中 
都 发 送 用 户 名 和 密码 ， 服 务 器 可 以 把 客户 端的 会 话 标记 为 已 通过 验证 ， 并 且 在 数据 库 
中 把 会 话 ID 和 用 户 ID 关联 起 来 。 
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To-Do lists - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 





| EiTo-Dolists | 号 | 
有 localhost vC©| 图 Goodle Q 也 合 长 
Superlists Logged in as harry@mockmyid.com Log out 


Start a new 
To-Do list 


Method File Domain Type 四 Headers Cookies Params Response Timings 


Network 








/ localhost:8000 
bootstrap.min.css localhost:8000 


Response cookies 
base.css localhost:8000 


v csrftoken "UZIRIU3DHqRhzjgWzM2NN3kB8LxCqxQq" 
expires: "2015-02-25T11:17:25.000Z" 
include.js login.persona.org j path: "/" 


accounts.js localhost:8000 


jquery.min.js code.jquery.com 


Request cookies 


listjs localhost:8000 js csrftoken "UZIRIU3DHqRhzjgWzM2NN3kB8LxCqxQq" 


communication_iframe login.persona.org html sessionid "8u0pygdy9blo696g3n40078ygt6l8y0y" 
session_context login.persona.org json 


. < 


All HTML Css JS XHR Fonts Images Media Flash 
@- * S99 








图 16-1: 在 调试 工具 条 中 查看 会 话 cookie 


会 话 的 数据 结构 有 点 儿 像 字典 ， 用 户 ID 存储 在 哪个 键 下 由 django.contrib.auth. 
SESSION_KEY 决定 。 如 果 需 要 ， 可 以 在 manage.py 的 终端 控制 台 查 看 会 话 : 

$ python3 manage.py shell 

[2 


In [1]: from django.contrib.sessions.models import Session 





# 这 里 会 显示 浏览 器 cookie 中 存储 的 会 话 ID 

In [2]: session = Session.objects.get( 
session_key="8uQpygdy9b1l0696g3n40078ygt6l8yQy" 

) 


In [3]: print(session.get_decoded()) 
{'_auth_user_id': 'harry@mockmyid.com', '_auth_user_backend': 
'accounts .authentication.PersonaAuthenticationBackend'} 


在 用 户 的 会 话 中 还 可 以 存储 其 他 任何 需要 的 信息 ， 作 为 临时 记录 某 种 状态 的 方式 。 对 
未 登录 的 用 户 也 可 以 这 么 做 。 在 任意 一 个 视图 中 使 用 request.session 即 可 ， 用 法 和 
在 用 户 的 会 话 中 还 可 以 存储 其 他 任何 需要 的 信息 ， 作 为 临时 记录 某 种 状态 的 方式 。 对 
未 登录 的 用 户 也 可 以 这 么 做 。 在 任意 一 个 视图 中 使 用 request.session 即 可 ， 用 法 和 
字典 一 样 。 如 果 想 了 解 更 多 信息 ， 请 阅读 Django 文档 中 对 会 话 的 说 明 (https://docs. 
djangoproject.com/en/1.7/topics/http/sessions/) 。 














得 到 的 是 两 个 失败 测试 


$ python3 manage.py test accounts 


Esa] 
self.assertEqual(self.client.session[SESSION KEY], user.pk) 


KeyError: '_auth_user_id' 
Ese 

AssertionError: '' != 'OK' 
+ OK 


处 理 用 户 登 录 以 及 标记 会 话 的 Django 函数 是 django.contrib.auth.login。 所 以 我 们 还 要 
历经 儿 次 TDD 循环 ， 最 终 才 能 编写 出 如 下 的 视图 : 





accounts/Views.py 


from django.contrib.auth import authenticate, login 
from django.http import HttpResponse 


def persona_login(request): 
user = authenticate(assertion=request.POST['assertion']) 
if user: 
login(request, user) 
return HttpResponse('OK') 


测试 结果 为 : 


OK 





至 此 ， 我 们 得 到 了 一 个 可 以 使 用 的 登录 视图 。 





使 用 驭 件 测试 登录 
测试 是 否 正 确 调用 Django 中 Login 涵 数 的 另 一 种 方法 也 是 模拟 Login 函数 : 
accounts/tests/test_views.py 


from django.http import HttpRequest 
from accounts.views import persona_login 


[...] 


@patch('accounts .views.login') 

@patch('accounts.views.authenticate') 

def test calls_auth login if_authenticate_ returns_a_user( 
self, mock_authenticate, mock_login 


): 
request = HttpRequest() 
request.POST['assertion'] = 'asserted' 
mock_user = mock_authenticate.return_value 
login(request) 





mock_login.assert_called_ once with(request, mock_user) 
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这 种 测试 方式 的 优点 是 ， 不 依赖 Django 测试 客户 萝 ， 也 不 用 知道 Django 会 话 的 工作 
方式 ， 只 需要 知道 你 要 调用 的 函数 名 即 可 。 


缺点 是 几乎 都 在 测试 实现 方式 ， 但 没 测试 行为 ， 而 且 和 Django 中 实现 登录 功能 的 函数 
名 和 API 结合 地 太 过 紧密 。 


16.3 ”模拟 网 络 请 求 ， 去 除 自 定义 认证 后 台中 的 
探究 代码 


接 下 来 我 们 要 自 定 义 认 证 后 台 。 探 究 时 编写 的 代码 如 下 所 示 : 








class PersonaAuthenticationBackend(object): 


def authenticate(self, assertion): 
# 把 判定 数据 发 送 给 Mozilla 的 验证 服务 
data = {'assertion': assertion, 'audience': 'localhost'} 
print('sending to mozilla', data, file=sys.stderr) 
resp = requests.post('https://verifier.login.persona.org/verify', data=data) 
print('got', resp.content, file=sys.stderr) 


# 验证 服务 器 有 响应 吗 ? 
if resp.ok: 
# 解析 响应 


verification data = resp.json() 


# 检查 判定 数据 是 否 有 效 








if verification data['status'] == 'okay': 
email = verification data['email'] 
try: 


return self.get user(email) 
except ListUser .DoesNotExist: 
return ListUser.objects.create(email=email) 


def get user(self, email): 
return ListUser.objects.get(email=email) 


这 段 代 码 的 意思 是 : 


。 使 用 requests.post 把 判定 数据 发 送 给 Mozilla; 

。 然后 检查 响应 码 (resp.ok)， 再 检查 响应 的 JSON 数据 中 status 字段 的 值 是 否 为 okay，; 

。 最 后 ， 从 响应 中 提取 电子 邮件 地 址 ， 通 过 这 个 地 址 找到 现 有 的 用 户 ， 如 果 找 不 到 就 创建 
一 个 新 用 户 。 









































16.3.1 一 个 if 语 句 需要 一 个 测试 
如 何 为 这 种 函数 编写 测试 有 个 经 验 法 则 ， 一 个 if 语句 需要 一 个 测试 ， 一 个 try/except 语 





270 | 第 16 章 


句 需 要 一 个 测试 。 所 以 一 共 需 要 四 个 测试 。 我 们 先 编写 第 一 





accounts/tests/test_authentication.py 


from unittest.mock import patch 
from django.test import TestCase 


from accounts.authentication import ( 
PERSONA_VERIFY_URL, DOMAIN, PersonaAuthenticationBackend 
) 


class AuthenticateTest(TestCase): 


@patch('accounts.authentication.requests.post') 
def test_ sends_assertion to mozilla with domain(self, mock_post): 
backend = PersonaAuthenticationBackend() 
backend.authenticate('an assertion') 
mock_post.assert_called_once with( 
PERSONA_VERIFY_URL ， 
data={'assertion': "an assertion', 'audience': DOMAIN} 


) 
在 authenticate.py 中 ， 我 们 先 编写 一 些 占 位 代码 : 








accounts/authentication.py 


import requests 

PERSONA_VERIFY_URL = 'https://verifier.login.persona.org/verify' 
DOMAIN = "LocaLhost 

class PersonaAuthenticationBackend(object): 


def authenticate(self, assertion): 
pass 


此 时 ， 我 们 需要 执行 下 述 命 


(virtualenv)$ pip install requests 


别 忘 了 把 requests 添加 到 requirements.txt 中 ， 否 则 下 一 次 部 署 会 失败 。 


然后 我 们 看 一 下 测试 结果 如 何 : 


$ python3 manage.py test accounts 
Lens:] 


AssertionError: Expected 'post' to be called once. Called 0 times. 


要 通过 这 个 测试 ， 我 们 还 要 走 三 步 (一 定 要 让 测试 山羊 看 到 每 一 步 你 都 走 了 )。 最 终 写 


的 代码 如 下 所 示 : 
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accounts/authentication.py 


def authenticate(self, assertion): 
requests.post( 
PERSONA_VERIFY_URL ， 
data={'assertion': assertion, 'audience': DOMAIN} 


) 
测试 全 部 通过 了 : 


$ python3 manage.py test accounts 


[多 2 
Ran 5 tests in 0.023s 
OK 

接 下 来 ， 我 们 检查 authenticate 函数 在 发 现 请 求 的 响应 中 有 错误 时 是 否 返 回 None: 


accounts/tests/test_authentication.py (ch161020) 


@patch('accounts.authentication.requests.post') 

def test_returns_none_if_response_errors(self, mock_post): 
mock_post.return_value.ok = False 
backend = PersonaAuthenticationBackend() 


User = backend.authenticate('an assertion') 
self.assertIsNone(user) 


这 个 测试 直接 就 能 通过 ， 基 


16.3.2 ”在 类 上 使 用 patch 修 饰 器 
接 下 来 我 们 要 检查 响应 的 JSON 数据 中 status 字段 是 否 为 okay。 编 写 这 个 测试 会 涉及 到 一 
些 重复 代码 ， 所 以 我 们 要 运用 “三 则 重 构 ” 原 则 : 











ey 
a 
带 
二 
N 
琉 
六 
过 
看 
[Gu 
入 | 





的 都 是 None。 








accounts/tests/test_authentication.py (ch161021) 


@patch('accounts.authentication.requests.post') #0 
class AuthenticateTest(TestCase): 


def setUp(self): 
seLf .backend = PersonaAuthenticationBackend() #@ 


def test_ sends_assertion to _ mozilla with domain(self, mock_post): 
self.backend.authenticate('an assertion') 
mock_post.assert_called_once with( 
PERSONA_VERIFY_URL ， 
data={'assertion': 'an assertion', 'audience': DOMAIN} 


def test_returns_none_if_response_errors(self, mock_post): 
mock_post.return_value.ok = False #@ 
user = self.backend.authenticate('an assertion') 





self.assertIsNone(user) 


def test returns_none_if_status_not okay(self, mock_post): 


mock_post.return_value.json.return_value = {'status': 'not okay!'} #@ 


User = self.backend.authenticate('an assertion') 
self.assertIsNone(user) 


@ patch 修饰 器 也 可 以 在 类 上 使 用 ， 这样， 类 中 的 每 个 测试 方法 都 会 应 用 这 





而 且 双 件 会 传 入 每 个 测试 方法 。 
@ ”现在 我 们 可 以 在 setup 函数 中 准备 所 有 测试 都 会 用 到 的 变量 。 














个 修饰 


口 RL 


好， 


@ @ 现在 每 个 测试 只 调整 需要 设 定 的 变量 ， 而 没有 设 定 一 堆 重 复 的 样板 代码 ， 所 以 测试 更 





具 易 读 性 。 
一 切 都 很 顺利 ， 测 试 仍 能 
OK 


现在 我 们 该 测试 能 通过 认证 的 情况 了 ， 看 authenticate 国 数 是 否 返 
期 望 下 面 这 个 测试 失败 : 


加 | 




















一 个 用 户 对 象 。 我 们 


accounts/tests/test_authentication.py (ch161022-1) 


from django.contrib.auth import get user_model 
User = get_user_model() 


本 
def test finds existing user with email(self, mock_post): 

mock_post.return_value.json.return_value = {'status': 'okay', 'email': 

b.com'} 
actual_user = User.objects.create(email='a@b.com') 
found_user = self.backend.authenticate('an assertion') 
self.assertEqual(found_user, actual_user) 

的 确 失败 了 : 
AssertionError: None != <User: > 


'a@ 


下 面 开始 编写 代码 。 我 们 先 用 一 个 “ 作 兹 ”的 实现 方式 ， 直 接 获 取 在 数据 库 中 找到 的 第 一 


个 用 户 : 


accounts/authentication.py (ch161023) 


import requests 
from django.contrib.auth import get user_model 
User = get_user_model() 


[...] 


def authenticate(self, assertion): 
requests.post( 
PERSONA_VERIFY_URL ， 
data={'assertion': assertion, 'audience': DOMAIN} 
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return User.objects.first() 





这 段 代 码 让 新 测试 通过 了 ， 但 其 他 测试 也 没有 失败 : 


$ python3 manage.py test accounts 


[3] 


Ran 8 tests in 0.030s 


OK 








测试 之 所 以 全 部 通过 ， 是 因为 如 果 数 据 库 中 没有 用 户 ，objects.first() 会 返回 None。 我 
们 要 保证 运行 每 个 测试 时 数据 库 中 都 至 少 有 一 个 用 户 ， 让 其 他 情况 更 可 行 一 些 : 








accounts/tests/test_authentication.py (ch161022-2) 


def setUp(self): 
seLf .backend = PersonaAuthenticationBackend() 
User = User(email='other@user .com ') 
User .Username = 'otheruser' #@ 
user .save() 


@ 在 默认 情况 下 ，Django 的 用 户 都 有 username 属性 ， 其 值 必须 具有 唯一 性 。 这 里 使 用 的 
值 只 是 一 个 占 位 符 ， 方 便 我 们 创建 多 个 用 户 。 后 面 我 们 要 使 用 电子 邮件 做 主键 ， 到 时 就 
不 用 用 户 名 了 。 


现在 有 三 个 测试 失败 了 : 


FAIL: test_ finds existing user_ with email 
AssertionError: <User: otheruser> != <User: > 
[ss 

FAIL: test_returns_none_if_response errors 
AssertionError: <User: otheruser> is not None 
| 

FAIL: test_returns_none_ if_status_not_okay 
AssertionError: <User: otheruser> is not None 


看 我 们 开始 编写 在 响应 出 错 或 状态 不 是 okay 的 情况 下 防范 认证 失败 的 代码 。 假 设 我 们 先 


这 样 写 ， 


















































也 











accounts/authentication.py (ch161024-1) 


def authenticate(self, assertion): 
response = requests.post( 
PERSONA_VERIFY_URL ， 
data={'assertion': assertion, 'audience': DOMAIN} 
) 
if response.json()['status'] == 'okay': 
return User.objects.first() 


实际 上 ， 这 么 写 能 修正 其 中 的 两 个 测试 ， 有 点 儿 意外 : 




















AssertionError: <User: otheruser> != <User: > 





FAILED (failures=1) 


下 面 我 们 取 回 正确 的 用 户 ， 让 最 后 一 个 测试 也 通过 ， 下 一 节 再 分 析 为 什么 能 神奇 般 地 通 


accounts/authentication.py (ch161024-2) 


if response.json()['status'] == 'okay': 
return User.objects.get(email=response.json()['email']) 
测试 结果 为 : 
OK 


16.3.3 ”进行 布尔 值 比较 时 要 留意 驭 件 


那么 为 什么 test_returns_none_if_response_errors 没有 失败 呢 ? 


因为 我 们 模拟 了 requests.post，response 是 驭 件 对 象 。 或 许 你 还 ， 它 返回 的 所 有 属 
性 和 也 都 是 驭 件 。” 所 以 ， 在 下 面 这 行 代码 中 : 











accounts/authentication.py 


if response.json()['status'] == 'okay': 














response i response.json() 也 是 驭 件 ，response.json()['status'] 还 是 
驭 件 。 最 终 ， 我 们 是 拿 一 个 驭 件 和 字符 串 “okay” 比 较 ， 所 以 比较 的 结果 是 False， 
此 authenticate 函数 的 返回 值 是 None。 我 们 要 把 测试 的 表述 改 得 更 明确 一 些 ， 把 响应 自 
JSON 数据 声明 为 一 个 空 字典 : 





| 








wT 


accounts/tests/test_authentication.py (ch161025) 


def test_returns_none_if_response_errors(self, mock_post): 
mock_post.return_vaLue.ok = False 
mock_post.return_value.json.return_value = {} 
user = self.backend.authenticate('an assertion') 
self.assertIsNone(user) 


此 时 ， 测 试 的 结果 为 : 

















if response.json()['status'] == 'okay ': 
KeyError: "status' 


这 个 问题 可 以 使 用 下 面 的 方式 修正 : 


accounts/authentication.py(ch161026) 


if response.ok and response.json()['status'] == 'okay': 
return User.objects.get(email=response.json()['email']) 
现在 测试 的 结果 为 : 














注 3: 其 实 , 只 有 使 用 patch 修饰 符 时 才 会 发 生 这 种 情况 ，response 其 实 是 MagicMock 对 象 ， 比 mock 模拟 的 层 
级 还 深 有 点 儿 像 字典 。 详 情 参 见 文档 (https://docs.python.org/3/library/unittest.mock.html#magicmock- 
and-magic-method-support ) 。 
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OK 


太 棒 了 ! 现在 authenticate 函数 的 工作 方式 正 符合 我 们 的 需求 。 


16.3.4 ”需要 时 创建 用 户 
如 果 传 入 authenticate 函数 的 判定 数据 经 Persona 确认 有 效 ， 而 且 数 据 库 中 没有 这 个 人 的 
用 户 记 录 ， 应 用 应 该 创建 一 个 新 用 户 。 相 应 的 测试 如 下 : 























accounts/tests/test_authentication.py (ch161027) 


def test creates new user_if necessary _for_valid assertion(self, mock_post): 
mock_post.return_value.json.return value = {'status': 'okay', 'email': 'a@b.com'} 
found_user = self.backend.authenticate('an assertion') 
New_user = User.objects.get(email="'a@b.com') 
self.assertEqual(found_user, new_user) 


当 应 用 的 代码 尝试 使 用 电子 邮件 地 址 查找 一 个 现 有 用 户 时 ， 这 个 测试 会 失败 : 


return User.objects.get(email=response.json()['email']) 
django.contrib.auth.models.DoesNotExist: User matching query does not exist. 


所 以 我 们 添加 一 个 try/except 语句 ， 暂 时 返回 一 个 没 设 定 任何 属性 的 用 户 : 

















accounts/authentication.py (ch161028) 


if response.ok and response.json()['status'] == 'okay': 
try: 
return User.objects.get(email=response.json()['email']) 
except User .DoesNotExist: 
return User.objects.create() 


测试 仍然 失败 ， 但 这 一 次 发 生 在 测试 尝试 使 用 电子 邮件 查找 新 用 户 时 : 


New_user = User.objects.get(email="'a@b.com') 
django.contrib.auth.models.DoesNotExist: User matching query does not exist. 

















所 以 ， 修 正 的 方法 是 给 email 属性 指定 正确 的 电子 邮件 地 址 : 








accounts/authentication.py (ch161029) 


if response.ok and response.json()['status'] == 'okay': 
email = response.json()['email'] 
try: 


return User.objects.get(email=email) 
except User .DoesNotExist: 
return User.objects.create(email=email) 


修改 之 后 ， 测 试 能 通过 了 : 


$ python3 manage.py test accounts 


[...] 
Ran 9 tests in 0.019s 
OK 





16.3.5 get_user 方 法 

接 下 来 我 们 要 为 认证 后 台 定义 get_user 方法 。 这 个 方法 的 作用 是 使 用 用 户 的 电子 邮件 地 
址 取 回 用 户 记录 ， 如 果 找 不 到 用 户 记 录 就 返回 None。( 写 作 本 书 时 ,“ 找 不 到 用 户 记录 ”的 
情况 文档 中 并 没有 说 明 ， 但 我 们 必须 这 么 做 。 详 情 参见 源码 : https://github.com/django/ 
django/blob/1.6c1/django/contrib/auth/backends.py#L.66., ) 




















针对 这 两 个 要 求 的 几 个 测试 如 下 所 示 : 


accounts/tests/test_authentication.py (ch161030) 


class GetUserTest(TestCase): 


def test gets user_by_email(self): 
backend = PersonaAuthenticationBackend() 
other_user = User(email='other@user .com') 
other_user .username = 'otheruser' 
other_user .save() 
desired user = User.objects.create(email='a@b.com') 
found_user = backend.get_ user('a@b.com') 
self.assertEqual(found_user, desired_user) 


def test_returns_none_if no_user_ with that email(self): 
backend = PersonaAuthenticationBackend() 
self.assertIsNone( 
backend.get_user('a@b.com') 


) 
首先 得 到 的 失败 消息 如 下 : 


AttributeError: 'PersonaAuthenticationBackend' object has no attribute 
'get_user' 


那 我 们 就 定义 一 个 占 位 方法 : 
accounts/authentication.py (ch161031) 
class PersonaAuthenticationBackend(object): 


def authenticate(self, assertion): 


[di 


def get user(self): 
pass 





F 


现在 的 测试 结果 为 : 
TypeError: get user() takes 1 positional argument but 2 were given 


那 就 添加 参数 : 
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accounts/authentication.py (ch161032) 


def get user(self, email): 
pass 





测试 结果 变 成 : 
self.assertEqual(found_user, desired_user) 


AssertionError: None != <User: > 


然后 一 步 一 步 编写 代码 ， 看 测试 是 否 会 按照 我 们 预期 的 那样 失败 : 
accounts/authentication.py (ch161033) 





def get user(self, email): 
return User.objects.first() 


现在 断言 的 第 一 个 参数 有 了 正确 的 值 ， 测 试 结果 变 成 : 

















self.assertEqual(found_user, desired_user) 
<User: otheruser> != <User: > 


F 作 为 参数 传 给 get 方法 : 


AssertionError: 





所 以 我 们 把 电子 邮 伯 
accounts/authentication.py (ch161034) 


def get user(self, email): 
return User.objects.get(email=email) 


第 一 个 测试 通过 了 。 
现在 检查 返回 None 的 测试 失败 了 ， 


ERROR: test_returns_none_if_no_user_with_that_ematiL 


[se] 
django.contrib.auth.models.DoesNotExist: User matching query does not exist. 





失败 消息 提醒 我 们 ， 可 以 按照 下 面 的 方式 写 完 这 个 方法 : 
accounts/authentication.py (ch161035) 


def get user(self, email): 
try: 
return User.objects.get(email=email) 


except User .DoesNotExist: 
return None #@ 


日 pass， 上 默认 情况 下 函数 会 返回 None。 不 过 ， 既 然 我 们 明确 要 求 这 个 函数 





@ 这 里 也 可 使 月 
回 None， 表 达 清 楚 比 含糊 其 辞 强 。 























返 
现在 第 二 个 测试 也 通过 了 : 





而 且 我 们 得 到 了 一 个 可 以 使 用 的 认证 后 台 。 
$ python3 manage.py test accounts 


Ran 11 tests in 0.020s 
OK 











7 


下 面 我 们 可 以 编写 自 定义 的 用 户 模 型 了 。 


八里 和 ou = 
16.4 ”一 个 最 简单 的 自 定义 用 户 模型 

Django 原生 的 用 户 模型 对 记录 什么 用 户 信息 做 了 各 种 设想 ， 明 确 要 记录 的 包括 名 和 姓 ， 而 
且 强 制 使 用 用 户 名 。 我 坚信 ， 除 非 真 的 需要 ， 否 则 不 要 存储 用 户 的 任何 信息 。 所 以 ,一 个 
只 记录 电子 邮件 地 址 的 用 户 模型 对 我 来 说 足够 了 。 



































accounts/tests/test models.py 


from django.test import TestCase 
from django.contrib.auth import get user_model 


User = get_user_model() 
class UserModelTest(TestCase): 
def test user_is valid with email_only(self): 
User = User(email="'a@b.com') 
user .fuLL_ ctLean() # 不 该 抛 出 异常 


测试 的 结果 是 一 个 预期 失败 : 


django.core.exceptions.ValidationError: {'username': ['This field cannot be 
blank.'], 'password': ['This field cannot be blank.']} 








密码 ?用 户 名 ? 不 ! 把 模型 写成 这 样 如 何 ? 





accounts/models.py 


from django.db import models 


class User(models.Model): 
email = models.EmailField() 





然后 在 settings.py 中 使 用 AUTH_USER_MODEL 变量 设 定 使 用 这 个 模型 。 同 时 ， 再 把 前 面 写 好 
的 认证 后 台 添 加 到 配置 中 : 














superlists/settings.py (ch161039) 


AUTH_USER_MODEL = 'accounts.User' 
AUTHENTICATION_BACKENDS = ( 
"accounts .authentication.PersonaAuthenticationBackend ' ， 


) 
现在 ，Django 告诉 我 们 有 些 错误 ， 因 为 自 定义 的 用 户 模 型 需要 一 些 元 信息 : 
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AttributeError: type object 'User' has no _ attribute ' REQUIRED_FIELDS 
唉 ，Django 啊 ， 这 个 模型 只 有 一 个 字段 而 已 ， 你 自己 应 该 能 找到 问题 的 答案 ， 就 像 这 样 : 


accounts/models.py 


class User(models.Model): 
email = models.EmailField() 
REQUIRED_FIELDS = () 


还 有 疑问 吗 ? ， 
AttributeError: type object 'User' has no _ attribute 'USERNAME_FIELD 
那 就 把 代码 改 成 : 


accounts/models.py 


class User(models.Model): 
email = models.EmailField() 
REQUIRED_FIELDS = () 
USERNAME_FIELD = 'email' 


接 下 来 会 看 到 一 个 数据 库 错 误 : 


django.db.utils.OperationalError: no such table: accounts_user 
和 之 前 一 样 ， 这 个 错误 提醒 我 们 ， 要 做 一 次 迁移 : 


$ python3 manage.py makemigrations 
System check identified some issues: 


WARNINGS: 
accounts.User: (auth.W004) 'User.email' is named as the 'USERNAME_FIELD', but 
it is not unique. 

HINT: Ensure that your authentication backend(s) can handle non-unique 
Usernames. 
Migrations for 'accounts’': 

0001_initial.py: 
- Create model User 


先 这 样 ， 我 们 看 一 下 测试 是 否 能 全 部 通过 。 
16.4.1 稍微 有 点 儿 失 望 


现在 ， 有 儿 个 测试 很 奇怪 ， 出 平 意料 地 失败 了 : 


$ python3 manage.py test accounts 


[5] 





注 4: 你 可 能 想 问 , 既然 我 觉得 Django 很 笨 , 为 什么 不 提交 “合并 请 求 ”(pull request) 修正 呢 ? 应 该 很 简单 。 
咽 ， 我 保证 等 我 写 完 这 本 书 之 后 会 这 么 做 的 。 尖 锐 的 批评 就 此 打住 吧 ! 














ERROR: test_gets_Logged_in_session_if_authenticate_returns_a_User 


[< 
ERROR: test_returns_0K_when_user_found 
[i] 
user .save(update fields=['last_login']) 
[...] 
ValueError: The following fields do not exist in this model or are m2m fields: 
Last_Login 








好 像 Django 坚持 要 求 用 户 模型 中 有 Last_Login 字段 。 噢 ， 好 吧 ， 我 无 法 坚守 只 有 一 个 字 
段 的 用 户 模型 了 ， 不 过 我 还 是 深 爱 着 它 。 





accounts/models.py 


from django.db import models 
from django.utils import timezone 


class User(models.Model): 
email = models.EmailField() 
last_login = models.DateTimeField(default=timezone.now) 
REQUIRED_FIELDS = () 
USERNAME_FIELD = 'email' 





tt 





我 们 又 得 到 了 另 一 个 数据 库 错 误 ， 那 么 就 把 前 一 个 迁移 文件 删除 ， 重 新 创建 : 


[eall 





$ rm accounts/migrations/0001_initial.py 
$ python3 manage.py makemigrations 
System check identified some issues: 
[ss 
Migrations for "acCounts ' : 
0001_initial.py: 
- Create model User 


现在 测试 都 能 通过 了 ， 不 过 还 有 一 些 警告 ; 





$ python3 manage.py test accounts 


| Wy 
System check identified some issues: 
WARNINGS: 


accounts.User: (auth.W004) 'User.email' is named as the 'USERNAME_FIELD', but 
it is not unique. 


Es 
Ran 12 tests in 0.041s 


OK 


16.4.2 ”把 测试 当 作 文档 


接 下 来 我 们 要 把 email 字段 设 为 主键 ， 因 此 必须 要 把 自动 生成 的 id 字段 删除 。 





虽然 那个 警告 可 能 表明 我 们 要 做 些 修改 ， 不 过 最 好 先 为 这 次 改动 编写 一 个 测试 : 
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accounts/tests/test models.py (ch161043) 


def test email is primary_key(self): 
user = User() 
self.assertFalse(hasattr(user, 'id')) 


如 果 以 后 回 过 头 来 再 看 代码 ， 这 个 测试 能 唤起 我 们 的 记忆 ， 知 道 曾经 做 过 这 次 修改 。 





self.assertFalse(hasattr(user, 'id')) 
AssertionError: True is not false 





测试 可 以 作为 一 种 文档 形式 ， 因 为 测试 体现 了 你 对 某 个 类 或 函数 的 需求 。 如 
果 你 忘记 了 为 什么 要 使 用 某 种 方法 编写 代码 ， 可 以 回 过 头 来 看 测试 ， 有 时 就 
能 找到 答案 。 这 就 是 为 什么 一 定 要 给 测试 方法 起 个 意思 明确 的 名 字 。 






































实现 的 方式 如 下 (可 以 先 使 用 unique=True 看 看 结果 如 何 ) : 
accounts/models.py (ch161044) 
email = models.EmailField(primary_key=True) 
这 么 写 确 实 有 用 : 


$ python3 manage.py test accounts 


Ls] 
Ran 13 tests in 0.021s 
OK 


最 后 ， 再 清理 一 下 迁移 ， 确 保 所 有 设 定 都 能 应 用 到 数据 库 中 : 

















$ rm accounts/migrations/0001_initial.py 
$ python3 manage.py makemigrations 
Migrations for 'accounts’': 
0001_initial.py: 
- Create model User 


现在 没有 警告 了 ! 


16.4.3 用户 已 经 通过 认证 

用 户 模型 还 需要 一 个 属性 才 算 完整 : 标准 的 Django 用 户 模 型 提供 了 一 个 API， 其 中 包含 很 
多 方法 (https://docs.djangoproject.com/en/1.7/ref/contrib/auth/#methods)， 大 多 数 我 们 都 不 需 
要 ,但 有 一 个 能 用 到 ,是 .is_authenticated(): 





accounts/tests/test models.py (ch161045) 


def test is authenticated(self): 
user = User() 
self.assertTrue(user .is_authenticated()) 
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测试 结果 为 : 


AttributeError: 'User' object has no _ attribute "is_authenticated ' 


也、 


解决 的 方法 十 分 简单 : 





accounts/models.py 


class User(models.Model): 
email = models.EmailField(primary_key=True) 
last_login = models.DateTimeField(default=timezone.now) 
REQUIRED_FIELDS = () 
USERNAME_FIELD = 'email' 


def is_authenticated(self): 
return True 


这 么 写 确实 管用 : 
$ python3 manage.py test accounts 
[5sx] 


Ran 14 tests in 0.021s 
OK 


Ab SS AALE 
16.5 关键 时 刻 : 功能 测试 能 通过 吗 
觉得 我 们 应 该 看 一 下 功能 测试 结果 如 何 了 。 下 面 我 们 来 修改 基 模 板 。 首 先 ， 已 登录 用 户 
和 未 登录 用 户 看 到 的 导航 条 应 该 不 同 : 




















lists/templates/base.html 


<nav class="navbar navbar-default" role="navigation"> 
<a class="navbar-brand" href="/">Superlists</a> 
{% if user.email %} 
<a class="btn navbar-btn navbar-right" id="id_logout" href="#">Log out</a> 
<span class="navbar-text navbar-right">Logged in as {{ user.email }}</span> 
{% else %} 
<a class="btn navbar-btn navbar-right" id="id_login" href="#">Sign in</a> 
{% endif %} 
</nav> 





妙 极 ! 然后 ， 我 们 把 几 个 上 下 文 变量 传人 initialize 方法 : 


lists/templates/base.html 


<script> 
/*global $, Superlists, navigator */ 
$(document).ready(function () { 
var user = "{{ user.email }}" || null; 
var token = "{{ csrf_token }}"; 
var urls = { 
login: "{% url 'persona_login' %}", 
logout: "TODO", 
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}; 
Superlists.Accounts.initialize(navigator, user, token, urls); 
]); 


</script> 
那么 功能 测试 结果 如 何 呢 ? 


$ python3 manage.py test functional_tests.test_login 
Creating test database for alias 'default'... 

| Wa 

Ran 1 test in 26.382s 


OK 


太 棒 了 ! 





在 此 之 前 我 一 直 没 提交 ， 因 为 我 在 等 待 一 切 都 能 顺利 运行 的 时 刻 。 此 时 ， 你 可 以 做 一 系列 
单独 的 提交 一 一 登录 视图 一 次 ， 认 证 后 台 一 次 ， 用 户 模型 一 次 ， 修 改 模型 一 次 。 或 者 ， 考 
虑 到 这 些 代 码 都 有 关联 ， 不 能 独自 运行 ， 也 可 以 做 一 次 大 提交 : 











$ git status 

$ git add . 

$ git diff --staged 

$ git commit -am "Custom Persona auth backend + custom user model" 


一 ab 二 站 ><、 各 已 
16.6 ”完善 功能 测试 ， 测 试 退出 功能 
我 们 要 扩展 功能 测试 ， 确 认 网 站 能 持久 保持 已 登录 状态 ， 也 就 是 说 这 并 不 只 是 我 们 在 客户 
端 JavaScript 代码 中 设 定 的 状态 ， 服 务 器 也 知道 这 个 状态 ， 而 且 刷 新 页 面 后 会 保持 已 登录 
状态 。 同 时 ， 我 们 还 要 测试 用 户 能 退出 。 





二 








我 先 编写 如 下 的 测试 代码 : 





functional tests/test login.py 








# 刷新 页 面 ,她 发 现 真 的 通过 会 话 登 录 了 

# 而 且 并 不 只 在 那个 页 面 中 有 效 

self.browser.refresh() 

self.wait for_element with id('id logout') 

navbar = self.browser.find element by_css_selector(' .navbar ') 
self.assertIn('edith@mockmyid.com', navbar.text) 
































我 们 重复 四 次 编写 了 十 分 类 似 的 代码 ， 所 以 可 以 定义 几 个 辅助 函数 : 





functional tests/test login.py (ch161050) 
def wait to_ be_ logged in(self): 
self.wait for_element with id('id logout') 
navbar = self.browser.find element by_css_selector(' .navbar ') 
self.assertIn('edith@mockmyid.com', navbar.text) 
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def wait_ to_be_logged out(self): 
self.wait for_element with id('id_ login') 
navbar = self.browser.find element_ by_css_selector(' .navbar ') 
self.assertNotIn('edith@mockmyid.com', navbar.text) 


然后 ， 我 把 功能 测试 扩展 成 这 样 : 





functional tests/test login.py (ch161049) 


[本 
# Persona 窗 口 关闭 了 


self.switch to_new window('To-Do') 





# 她 看 到 自己 已 经 登录 了 
self.wait to_be_logged in() 




















# La 她 发 现 真 的 通过 会 话 登 录 了 
self. Be refresh() 
self.wait to_be_logged in() 




















# 对 这 项 新 功能 有 些 恐 慢 , 她 立马 点 击 了 退出 按钮 
self.browser.find_ element_ by _id('id logout').click() 
self.wait to_be_logged out() 











# 刷新 后 仍旧 保持 退出 状态 
seLf .browser .refresh() 
self.wait to_be_logged out() 











我 还 发 现 改 进 wait_for_element_with_id 函数 中 的 失败 消息 有 助 于 看 清 发 生 了 什么 


functional tests/test login.py 


def wait for_element with id(self, element id): 
WebDriverWait(self.browser, timeout=30).until( 
Lambda b: b.find element by _ id(element id), 
'Could not find element with id {}. Page text was {}'.format( 
element_id, self.browser.find_ element_by_tag_name('body').text 


) 
这 样 修改 之 后 ， 我 们 看 到 ， 测 试 失败 的 原因 是 退出 按钮 没 起 作用 : 


$ python3 manage.py test functional._tests.test_login 

File "/workspace/superlists/functional_tests/test_login.py", line 36, in 
wait_to_be_logged out 
Lx 
selenium.common.exceptions.TimeoutException: Message: 'Could not find element 
with id id login. Page text was Superlists\nLog out\nLogged in as 
edith@mockmyid.com\nStart a new To-Do List' 

















实现 退出 功能 的 方法 其 实 很 简单 ， 我 们 可 以 使 用 Django 原生 的 退出 视图 (https://docs. 
djangoproject.com/en/1.7/topics/auth/default/#module-django.contrib.auth.views)。 这 个 视图 会 


清空 用 户 的 会 话 ， 然 后 重 定向 到 我 们 指定 的 页 面 : 
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accounts/urls.py 
urlpatterns = patterns('', 
url(r'^login$', 'accounts.views.persona_login', name='persona_login'), 
url(r'^logout$', 'django.contrib.auth.views.logout', {'next page': '/'}, 
name='Logout ' ) ， 


) 
然后 在 base.html 中 ， 把 退出 按钮 写成 一 个 普通 的 URL 链接 : 





lists/templates/base.html 


<a class="btn navbar-btn navbar-right" id="id logout" href="{% url 'logout' %}">Log 
out</a> 





现在 ， 功 能 测试 都 能 通过 了 。 其 实 ， 整 个 测试 组 件 都 可 以 通过 
$ python3 manage.py test functional_tests.test_login 


OK 
$ python3 manage.py test 
[...] 


Ran 54 tests in 78.124s 


OK 





下 一 章 我 们 要 充分 使 用 登录 系统 。 现 在 ， 做 次 提交 ， 然 后 阅读 总 结 





在 Python 中 使 用 模拟 技术 
。 Mock 库 


Michael Foord (在 我 加 入 PythonAnywhere 之 前 ， 他 在 孕育 PythonAnywhere 的 公司 
工作 ) 开发 了 很 优秀 的 Mock 库 ， 现 在 这 个 库 已 经 集成 到 Python 3 的 标准 库 中 。 这 
个 库 包 含 了 在 Python 中 使 用 模拟 技术 所 需 的 几乎 全 部 功能 


。 patch 修饰 器 
unittest.mock 模块 提供 了 一 个 函数 叫 作 patch， 可 用 来 模拟 要 测试 的 模块 中 任何 一 
个 对 象 。patch 一 般 用 来 修饰 测试 方法 ， 不 过 也 可 以 修饰 测试 类 ， 然 后 应 用 到 类 中 
的 所 有 测试 方法 上 。 


驭 件 是 真 值 ， 可 能 会 掩盖 错误 


要 知道 ， 模 拟 的 对 象 在 if 语句 中 的 表现 可 能 有 违 常 规 。 驭 件 是 真 值 ， 而且 还 能 掩 
盖 错 误 ， 因 为 驭 件 有 所 有 的 属性 和 方法 。 


了 驭 件 太 多 会 让 代码 变味 
在 测试 中 过 多 地 使 用 驭 件 会 导致 测试 和 实现 联系 十 分 紧 害 。 有 时 无 法 避免 出 现 这 种 
情况 。 但 一 般 而 言 ， 你 可 以 找到 一 种 组 织 代 码 的 方式 ， 避 免 使 用 太 多 驭 件 。 
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第 17 章 


测 研 固件 、 日 志和 服务 右 端 调试 








有 了 一 个 可 以 使 用 的 认证 系统 ， 现 在 使 用 这 个 系统 来 识别 用 户 ， 展 示 用 户 创建 的 所 有 
清单 。 








为 此 ， 要 在 功能 测试 中 使 用 已 经 登录 的 用 户 对 象 。 但 不 能 每 个 测试 都 使 用 Persona 认证 用 
户 ， 这 么 做 浪费 时 间 ， 所 以 跳 过 这 一 步 。 











分 离 关注 点 。 功 能 测试 和 单元 测试 的 区 别 在 于 ， 前 者 往往 不 止 有 一 个 断言 。 但 ， 理 论 上 一 
个 测试 只 应 该 测试 一 件 事 ， 所 以 没 必 要 在 每 个 功能 测试 中 都 测试 登录 和 退出 功能 。 如 果 能 
找到 一 种 方法 “ 作 次 *"， 跳 过 认证 ， 就 不 用 花 时 间 等 待 执 行 完 重复 的 测试 路 符 了 。 











在 功能 测试 中 去 除 重复 时 不 要 做 得 过 火 了 。 功 能 测试 的 优势 之 一 是 ， 可 以 捕 
获 应 用 不 同 部 分 之 间 交 互 时 产生 的 神秘 莫 测 的 表现 。 











17.1 事先 创建 好 会 话 ， 跳 过 登录 过 程 


用 户 再 次 访问 网 站 时 cookie 依然 存在 ， 这 种 现象 很 常见 。 也 就 是 说 ， 之 前 用 户 已 经 通过 认 
证 了 。 所 以 这 种 “ 作 刺 ”手段 并 非 异 想 天 开 。 有 具体 的 做 法 如 下 : 





functional tests/test my lists.py 
from django.conf import settings 
from django.contrib.auth import BACKEND_SESSION_KEY, SESSION_KEY, get_user_model 
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User = get_user_model() 
from django.contrib.sessions.backends.db import SessionStore 


from .base import FunctionalTest 


class MyListsTest(FunctionalTest): 


def create pre_authenticated_ session(self, email): 

User = User.objects.create(email=email) 

session = SessionStore() 

session[SESSION_KEY] = user.pk #@ 

session[BACKEND_SESSION_KEY] = settings.AUTHENTICATION_BACKENDS[0] 

session.save() 

扒 为 了 设 定 cookie ,我们 要 先 访问 网 站 

## 而 404 页 面 是 加 载 最 快 的 

self.browser.get(self.server_uyrl + "/404_no_such_url/") 

self.browser .add_cookie(dict( 
name=settings.SESSION_COOKIE_NAME, 
value=session.session_ key, #@ 
path="/'， 

)) 


@ 在 数据 库 中 创建 一 个 会 话 对 象 。 会 话 键 的 
地 址 。 











pe 


直 是 用 户 对 象 的 主键 ， 即 用 户 的 电子 邮件 




















@ 然后 把 一 个 cookie 添加 到 浏览 器 中 ，cookie 的 值 和 服务 器 中 的 会 话 匹配 。 这 样 再 次 访 
问 网 站 时 ， 服 务 器 就 能 识别 已 登录 的 用 户 。 











注意 ， 这 种 做 法 仅 当 使 用 LiveServerTestCase 时 才 有 效 ， 所 以 已 创建 的 User 和 Session 对 
象 只 存在 于 测试 服务 器 的 数据 库 中 。 稍 后 修改 实现 的 方式 ， 让 这 个 测试 也 能 在 过 渡 服 务 器 
里 的 数据 库 中 运行 。 














JSON 格式 的 测试 固件 有 危害 
使 用 测试 数据 预先 填充 数据 库 的 过 程 ， 例 如 存储 User 对 象 及 其 相关 的 Session 对 象 ， 
叫 作 设 定 “ 测 试 固件 ” (test fxture ) 。 


Django 原生 支持 把 数据 库 中 的 数据 保存 为 JSON 格式 (使 用 manage.py dunpdata 命 
令 )。 如 果 在 TestCase 中 使 用 类 属性 fixtures， 运 行 测试 时 Django 会 自动 加 载 JSON 
格式 的 数据 。 


越 来 越 多 的 人 建议 不 要 使 用 JSON 格式 的 固件 (http://blog.muhuk.com/2012/04/09/carl- 
Imeyers-testing-talk-at-pycon-2012.html#.USXCBPRdXcQ)。 如 果 修 改 了 模型 ， 这 种 固 
件 维护 起 来 像 嘲 梦 。 因 此 ， 只 要 可 以 ， 就 直接 使 用 Django ORM 加 载 数据 ， 或 者 使 用 
factory_boy (https://factoryboy.readthedocs.org/) 之 类 的 工具 。 

















检查 是 否 可 行 


i 





要 检查 这 种 做 法 是 否 可 行 ， 最 好 使 用 前 面 测试 中 定义 的 wait_to_be_logged_iin 函数 。 要 想 
人 在 不 同 的 测试 中 访问 这 个 方法 ， 就 要 把 它 连 同 另外 几 个 方法 一 起 移 到 FunctionalTest 类 
中 。 还 得 稍微 修改 这 几 个 方法 ， 让 它们 可 以 接收 任意 的 电子 邮件 地 址 作为 参数 : 




















functional tests/base.py (ch171002-2) 


from selenium.webdriver.support.ui import WebDriverWait 


[...] 


class FunctionalTest(StaticLiveServerCase): 


[a 


def wait for_element with id(self, element id): 


[...] 


def wait to_be logged in(self, email): 
self.wait for_element with id('id logout') 
navbar = self.browser.find element by_css_selector(' .navbar ') 
self.assertIn(email, navbar.text) 


def wait to_be_ logged out(self, email): 
self.wait for_element with id('id login') 
navbar = self.browser.find element by_css_selector(' .navbar ') 
self.assertNotIn(email, navbar.text) 


所 以 ，test_login.py 也 要 稍微 调整 一 下 : 














functional tests/test login.py (ch171003) 


TEST_EMAIL = 'edith@mockmyid.com' 
[ze] 


def test login with persona(self): 


[5 


self.browser .find_ element_ by_id( 
'authentication_email' 
).send_keys(TEST_EMAIL) 
self.browser .find_ element_ by_tag_name('button').click() 


[...] 


# 她 发 现 自己 已 经 登录 

self.wait to_ be logged in(email=TEST_EMAIL) 
[...] 

self.wait_ to_be_logged_in(email=TEST_EMAIL) 
[i 

self.wait to_be_ logged out(email=TEST_EMAIL) 


| | 
self.wait to_be logged out(email=TEST_EMAIL) 
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为 了 确认 我 们 没有 破坏 现 有 功能 ， 再 次 运行 登录 测试 : 
$ python3 manage.py test functional_tests.test_login 


[ed] 
OK 


现在 可 以 为 “My Lists” 页 面 编 写 一 个 占 位 测试 ， 检 查 事先 创建 认证 会 话 的 做 法 是 否 可 行 








functional tests/test my _ lists.py (ch171004) 
def test logged in users_lists are_ saved as my_lists(self): 
email = 'edith@example.com' 


seLf .browser .get(self.server_url) 
seLf .wait_to_be_Logged_out(ematiL) 




















# 伊 迪 丝 是 已 登录 用 户 


self.create pre_authenticated_session(email) 





seLf .browser .get(self.server_url) 
self.wait to_ be _ logged in(email) 

















测试 的 结果 为 : 
$ python3 manage.py test functionaL_tests.test_my_Lists 


[as 
OK 


现在 是 提交 的 好 时 机 : 


$ git add functional_tests 
$ git commit -m"placeholder test_my_Lists and move login checkers into base" 


17.2 ”实践 是 检验 真理 的 唯一 标准 : 在 过 渡 服 务 器 
中 捕获 最 后 的 问题 
这 个 功能 测试 在 本 地 运行 一 切 顺 利 ， 但 在 过 渡 服 务 器 中 情况 如 何 呢 ? 部 署 网 站 试 一 下 。 在 


文 个 过 程 中 会 遇 到 一 个 意料 之 外 的 问题 (体现 了 过 渡 服 务 器 的 作用 )， 为 了 解决 这 个 问题 
要 找到 在 测试 服务 器 中 管理 数据 库 的 方法 。 














$ cd deploy_tools 
$ fab deploy --host=superlists-staging.ottg.eu 
| We | 


然后 重启 Gunicorn: 





elspeth@server: sudo restart gunicorn-superlists-staging.ottg.eu 


运行 功能 测试 得 到 的 结果 如 下 : 
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$ python3 manage.py test functional_tests \ 
--liveserver=superlists-staging.ottg.eu 


Traceback (most recent call last): 
File "/worskpace/functional_tests/test_login.py", line 50, in 
test_login with_persona 


[...] 
self.wait for_element with id('id_ logout') 
Es] 


selenium.common.exceptions.TimeoutException: Message: 'Could not find element 
with id id logout. Page text was Superlists\nSign in\nStart a new To-Do List' 


ERROR: test_ logged in users_lists are saved as my_lists 
(functional_tests.test my_lists.MyListsTest) 
Traceback (most recent call last): 

File "/worskpace/functional_tests/test my_lists.py", line 34, iin 
test_logged_ in users_lists are_saved as my_lists 

self.wait to_be_ logged in(email) 

|| 
selenium.common.exceptions.TimeoutException: Message: 'Could not find element 
with id id logout. Page text was Superlists\nSign in\nStart a new To-Do List' 





无 法 登录 ， 不 管 真 的 使 用 Persona 还 是 使 用 已 经 通过 认证 的 会 话 都 不 行 。 这 说 明 测 试 有 问题 。 


我 考虑 过 回 到 前 一 章 修 正 这 个 问题 ， 然 后 假装 什么 都 没 发 生 ， 但 最 终 决 定 保 留 这 个 问题 ， 
以 此 体现 在 过 渡 环 境 中 运行 测 | 试 的 重要 性 。 如 有 果 直 接 把 代码 部 署 到 线 上 网 站 ， 一 定 会 落 入 
极为 尴 众 的 境地 。 


除了 修正 这 个 问题 之 外 ， 还 要 练习 如 何 使 用 服务 器 端 调试 技术 。 





17.2.1 设置 日 志 


为 了 记录 这 个 问题 ， 配 置 Gunicorn， 让 它 记 录 日 志 。 在 服务 器 中 使 用 vi 或 nano 按照 下 再 
的 方式 调整 Gunicorn 的 配置 : 














Server: /etc/init/eunicorn-superlists-staging.otte.eu.conf 
| 
exec ../virtualenv/bin/gunicorn \ 
--bind unix:/tmp/superlists-staging.ottg.eu.socket \ 
--access-logfile ../access.log \ 
--error-logfile ../error.log \ 
superlists.wsgi:application 


这 样 配 置 之 后 ，Gunicorn 会 在 ~/sites/$SITENAME 文件 夹 中 保存 访问 日 志和 错误 日 志 。 然 
后 在 authenticate 函数 中 调用 日 志 相 关 的 函数 输出 一 些 调试 信息 (这 一 步 也 可 以 直接 在 服 





T 
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务 器 上 操作 ) : 


accounts/authentication.py 


def authenticate(self, assertion): 
logging.warning('entering authenticate function') 
response = requests.post( 
PERSONA_VERIFY_URL, 
data={'assertion': assertion, 'audience': settings.DOMAIN} 
) 
logging.warning('got response from persona') 
logging.warning(response.content.decode()) 


[...] 


像 这 样 直接 调用 日 志 记 录 器 (logging.warning) 不 太 好 ， 本 章 末尾 会 设 定 一 
个 更 可 靠 的 日 志 配 置 。 





还 要 确保 settings.py 中 仍 有 LOGGING 设置 ， 这 样 调试 信息 才能 输送 到 终端 。 





superlists/settings.py 


LOGGING = { 
'version': 1， 
'disable existing_loggers': False, 
'handlers': { 
'console': { 
'level': 'DEBUG', 


'class': 'logging.StreamHandler', 
}; 
}, 
'loggers': { 
'django': { 
'handlers': ['console'], 
}; 
}, 


'root': {'level': 'INFO'}, 
} 


再 次 重启 Gunicom， 然 后 运行 功能 测试 ， 或 者 手动 登录 试 试 。 在 这 些 操作 执行 的 过 程 中 ， 
可 以 使 用 下 面 的 命令 监视 日 志 : 





elspeth@server: $ tail -f error.log # assumes we are in ~/sites/$SITENAME folder 


Ei 


WARNING:root:{"status":"failure","reason":"audience mismatch: domain mismatch"} 


有 可 能 发 现 页 面 陷 入 了 “ 重 定向 循环 "， 因 为 Persona 不 断 尝试 重新 提交 判定 数据 。 








发 生 这 种 事情 的 原因 是 ， 我 忽略 了 Persona 系统 的 一 个 重要 部 分 ， 即 认证 只 在 特定 的 域名 
中 有 效 。 在 accounts/authentication.py 中 把 域名 硬 编 码 成 “localhost”: 
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accounts/authentication.py 


PERSONA_VERIFY_URL = 'https://verifier.login.persona.org/verify'’ 
DOMAIN = 'localhost' 
User = get_user_model() 


我 们 可 以 在 服务 器 上 尝试 修正 : 


accounts/authentication.py 
DOMAIN = 'superlists-staging.ottg.eu’ 





然后 手动 登录 ， 确 认 这 人 么 改 是 否 有 用 。 结 果 证 明 有 用 。 


17.2.2 ”修正 Persona 引 起 的 这 个 问题 


真正 的 修正 方法 如 下 所 示 。 在 本 地 电脑 中 修改 代码 ， 首 先 把 poMAIN 变量 移 到 settings.py 
中 ， 稍 后 可 以 在 部 署 脚本 中 重 定义 这 个 变量 : 














superlists/settings.py(ch171011). 


# 部 署 脚本 会 修改 这 个 变量 
DOMAIN = "localhost" 


ALLOWED_HOSTS = [DOMAIN] 
然后 修改 测试 ， 应 对 上 述 改动 : 


accounts/tests/test_authentication.py 
@@ -1,12 +1,14 @@ 
from unittest.mock import patch 
+from django.conf import settings 
from django.contrib.auth import get_user_model 
from django.test import TestCase 
User = get _ user_model() 


from accounts.authentication import ( 
- PERSONA_VERIFY_URL, DOMAIN, PersonaAuthenticationBackend 
+ PERSONA_VERIFY_URL, PersonaAuthenticationBackend 


年 


@patch('accounts.authentication.requests.post') 
class AuthenticateTest(TestCase): 


@@ -21,7 +23,7 @@ class AuthenticateTest(TestCase): 
self.backend.authenticate('an assertion') 
mock_post.assert_called_once with( 

PERSONA_VERIFY_URL ， 
- data={'assertion': 'an assertion', 'audience': DOMAIN} 
+ data={'assertion': 'an assertion', 'audience': settings.DOMAIN} 
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接着 ， 修 改 实现 方式 : 


accounts/authentication.py 
QQ -1,8 +1,8 @@ 
import requests 
+from django.conf import settings 
from django.contrib.auth import get user_model 
User = get_ user_model() 


PERSONA_VERIFY_URL = 'https://verifier.login.persona.org/verify' 
-DOMAIN = 'localhost'" 


@@ -11,7 +11,7 @@ class PersonaAuthenticationBackend(object): 
def authenticate(self, assertion): 
response = requests.post( 
PERSONA_VERIFY_URL, 
- data={'assertion': assertion, 'audience': DOMAIN} 
+ data={'assertion': assertion, 'audience': settings.DOMAIN} 
) 
if response.ok and response.json()['status'] == 'okay': 
email = response.json()['email'] 


运行 测试 确认 一 下 : 


$ python3 manage.py test accounts 


[Ss] 
Ran 14 tests in 0.053s 
OK 





然后 











再 修改 fabfile.py， 让 它 调整 settings.py 中 的 域名 ， 同 时 删除 使 用 sed 修改 ALLOWED_ 





HOSTS 那 两 行 多 余 的 代码 : 


重新 部 署 ， 看 输出 中 有 没 执行 sed 修改 DOMAIN 的 值 : 








deploy tools/fabfile.py 


def update settings(source folder, site name): 
settings_path = source folder + '/superlists/settings.py' 
sed(settings_path, "DEBUG = True", "DEBUG = False") 
sed(settings_path, 'DOMAIN = "localhost"', 'DOMAIN = "%s"' % (site_name,)) 
secret key file = source folder + '/superlists/secret key.py' 
if not exists(secret key file): 


[2] 

















$ fab deploy --host=superlists-staging.ottg.eu 

[se 

[superLists-staging.ottg.eu] run: sed -i.bak -r -e s/DOMAIN = 
"localhost"/DOMAIN = "superlists-staging.ottg.eu"/g "$(echo 
/home/harry/sites/superlists-staging.ottg.ey/source/superlists/settings.py)" 


[...] 





17.3 ”在 过 渡 服务 器 中 管理 测试 数据 库 


现在 可 以 再 次 运行 功能 测试 ， 此 时 又 会 看 到 一 个 失败 测试 ， 因 为 无 法 创建 已 经 通过 认证 的 
会 话 ， 所 以 针对 “My Lists” 页 面 的 测试 失败 了 : 

















世 























$ python3 manage.py test functional._tests \ 
--liveserver=superlists-staging.ottg.eu 


ERROR: test_logged in users_lists are saved as my_lists 
(functional_tests.test my_lists.MyListsTest) 

| 

selenium.common.exceptions.TimeoutException: Message: 'Could not find element 
with id id logout. Page text was Superlists\nSign in\nStart a new To-Do List' 


Ran 7 tests in 72.742s 


FAILED (errors=1) 





失败 的 真正 原因 是 create_pre_authenticated_session 国 数 只 能 操作 本 地 数据 库 。 要 找到 
一 种 方法 ， 管 理 服 务 器 中 的 数据 库 。 























17.3.1 创建 会 话 的 Django 管 理 命令 
若 想 在 服务 器 中 操作 ， 就 要 编写 一 个 自 成 一 体 的 脚本 ， 在 服务 器 中 的 命令 行 里 运行 。 大 多 
数 情况 下 都 会 使 用 Fabric 执行 这 样 的 脚本 。 


























尝试 编写 可 在 Django 环境 中 运行 的 独立 脚本 (和 数据 库 交 互 等 )， 有 些 问 题 要 谨慎 处 理 ， 
例如 正确 设 定 DJIANG0_SETTINGS_MODULE 环境 变量 ， 还 要 正确 处 理 sys.path。 我 们 可 不 想 
在 这 些 细节 上 浪费 时 间 。 其 实 Django 允许 我 们 自己 创建 “管理 命令 ”( 可 以 使 用 python 
manage.py 运行 的 命令 )， 可 以 把 一 切 琐碎 的 事情 都 交 给 Django 完成 。 管 理 命 令 保 存在 应 
用 的 management/commands 文件 夹 中 : 



































$ mkdir -p functional_tests/management/commands 
$ touch functional_tests/management/__iinit__.py 
$ touch functional_tests/management/commands/_ iinit __.py 














管理 命令 的 样板 代码 是 一 个 类 ， 继 承 自 django.core.management.BaseCommand， 而 且 定 义 了 
一 个 名 为 handle 的 方法 : 














functional tests/management/commands/create_session.py 


from django.conf import settings 

from django.contrib.auth import BACKEND_SESSION KEY, SESSION_KEY, get_user_model 
User = get user_model() 

from django.contrib.sessions.backends.db import SessionStore 

from django.core.management.base import BaseCommand 


class Command(BaseCommand): 
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def handle(self, email, * ，xx* ): 
session key = create_pre_authenticated session(email) 
self.stdout.write(session_key) 


def create_pre_authenticated_ session(email): 
User = User.objects.create(email=email) 
session = SessionStore() 
session[SESSION_KEY] = user.pk 
session[BACKEND_SESSION_KEY] = settings.AUTHENTICATION_BACKENDS[0] 
session.save() 
return session.session key 





create_pre_ ne a 函数 的 代码 从 test_my_lists.py 文件 中 提取 而 来 。handle 
Ek 命令 人 返回 一 个 将 要 存 入 浏览 器 cookie 中 的 会 
话 键 。 这 个 管理 命令 还 会 把 会 话 键 打 印 到 命令 行 中 。 试 一 下 这 个 命令 








$ python3 manage.py create_session a@b.com 
Unknown command: 'create_session' 


还 要 做 一 步 设置 一 把 funetional_tests 加 入 setingwpy， 让 Django 把 它 识别 为 一 个 可 能 





superlists/settings.py 


+++ b/superlists/settings.py 

QQ -42,6 +42,7 QQ INSTALLED APPS = ( 
'lists', 
"south ' ， 
"acCounts ' ， 

十 'functional_tests', 


) 

















现在 这 个 管理 命令 可 以 使 用 了 : 





$ python3 manage.py create_session a@b.com 
qnslckvp2aga7tm6xuivybQob1iakzzwl 


17.3.2 ”让 功能 测试 在 服务 器 上 运行 管理 命令 


接 下 来 调整 test_my_lists.py 文件 中 的 测试 ， 让 它 在 本 地 服务 器 中 运行 本 地 函数 ， 但 是 在 过 
渡 服 务 器 中 运行 管理 命令 : 





functional tests/test my _ lists.py (ch171016) 


from django.conf import settings 

from .base import FunctionalTest 

from .server_tools import create_ session on_server 

from .management.commands.create_session import create_pre_authenticated_session 





class MyListsTest(FunctionalTest): 


def create_pre_authenticated session(self, email): 
if self.against_ staging: 
session key = create_session on_server(self.server_host, email) 
else: 
session key = create_pre_authenticated_session(email) 
椅 为 了 设 定 cookie ,我 们 要 先 访问 网 站 
检 而 404 页 面 是 加 载 最 快 的 
self.browser.get(self.server_url + "/404_no_such_url/") 
self.browser .add_cookie(dict( 
name=settings.SESSION_COOKIE_NAME, 
value=session_key, 
path="'/"'，, 
)) 


[过 
看 一 下 如 何 判 断 是 否 运 行 在 过 渡 服 务 器 中 。self.against_staging 的 值 在 base.py 中 设 定 : 
functional tests/base.py (ch171017) 
from .server_tools import reset database #@ 
class FunctionalTest(StaticlLiveServerCase): 
@classmethod 
def setUpClass(cls): 
for arg in sys.argv: 


if 'liveserver' in arg: 
cls.server_host = arg.split('=')[1] #@ 


cls.server_uyrl = 'http://' + cls.server_host 
cls.against_staging = True #@ 
return 


super().setUpClass() 
cls.against_staging = False 
cls.server_url = cls.live_ server_url 


@classmethod 
def tearDownClass(cls): 
if not cls.against_staging: 
super().tearDownClass() 


def setUp(self): 
if self.against_staging: 
reset_database(seLf.server_host) #@ 
self.browser = webdriver.Firefox() 
self.browser.implicitly_wait(3) 


@@ 如 有 果 检 测 到 命令 行 参数 中 有 liveserver， 就 不 仅 存储 cls.server_url 属性 ， 还 存储 
性 。 

















server_host 和 against_staging 属 





0@ @ 还 需要 在 两 次 测试 之 间 还 原 服务 器 中 数据 库 的 方法 。 稍 后 我 会 解说 创建 会 话 这 段 代码 
的 逻辑 ， 以 及 为 什么 可 以 这 么 做 。 
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17.3.3 ”使 用 subprocess 模 块 完成 额外 的 工作 
我 们 的 测试 使 用 Python 3， 不 能 直接 调用 Fabric 函数 ， 因 为 Fabric 只 能 在 
用 。 所 以 要 做 些 额外 工作 ， 像 部 署 服 务 器 时 一 样 ， 在 新 进程 中 执行 fab 命令 。 
工作 如 下 ， 代 码 写 入 server_tools 模块 中 : 




















Python 2 中 使 
要 做 的 额外 


functional tests/server_tools.py 


from os import path 
import subprocess 
THIS_FOLDER = path.abspath(path.dirname(__file_)) 


def create_session_on_server(host, email): 
return subprocess.check_output( 
[ 
'fab', 
'create_session_on_server:email={}'.format(email), #0@ 
'--host={}' .format(host) ， 
'--hide=everything,status', #@ 
]， 
cwd=THIS_FOLDER 
).decode().strip() #@ 


def reset database(host): 
subprocess.check_call( 
['fab', 'reset database', '--host={}'.format(host)], 
cwd=THIS_FOLDER 
) 


这 里 使 用 subprocess 模块 通过 fab 命令 调用 几 个 Fabric 国 数 。 


@ ”可 以 看 出 ， 在 命令 行 中 指定 fab 函数 的 参数 使 用 的 句法 很 简单 ， 冒 号 后 跟着 “变量 = 








参数 ”形式 的 写法 。 








@” 而且， 这 也 是 我 第 一 次 展示 如 何 使 用 格式 化 字符 串 的 新 句法 。 可 以 看 出 ， 新 句法 没 用 
%s， 用 的 是 花 括 号 从。 和 旧 句 法 相 比 ， 我 更 喜欢 新 句法 。 但 是 ， 不 管 使 用 了 Python 
多 久 ， 都 一 定 会 遇 到 这 两 种 句法 。 详 细 用 法 参阅 Python 文档 中 的 用 法 举例 〈http:/ 








docs.python.org/3/library/string.html#format-examples ) 。 





上 日 @ 因为 这 些 工作 通过 Fabric 和 子 进程 完成 ， 而 且 在 服务 器 中 运行 ， 所 以 从 命令 行 的 输出 





中 提取 字符 串 形式 的 会 话 键 时 一 定 要 格外 小 心 。 


如 果 使 用 自 定义 的 用 户 名 或 密码 ， 可 能 需要 修改 调用 subprocess 那 行 代 码 ， 
部 署 脚本 时 fab 命令 的 参数 保持 一 致 。 


和 运行 自动 化 





阅读 本 书 时 ，Fabric 可 能 已 经 完全 移植 到 Python 3 了 。 如 果 是 这 样 ， 请 自行 











研究 如 何 使 用 Fabric 上 下 文 管理 器 直接 在 代码 中 调用 Fabric 函数 。 
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最 后 ， 看 一 下 fabfile.py 中 定义 的 那 两 个 在 服务 器 端 运行 的 命令 。 这 两 个 命令 的 作用 是 还 原 
数据 库 和 设置 会 话 : 





functional tests/fabfile.py 


from fabric.api import env, run 


def get_ base folder(host): 
return '~/sites/' + host 


def get manage dot py(host): 
return '{path}/virtualenv/bin/python {path}/source/manage.py' .format( 
path=_get_base_folder(host) 


def reset_database(): 
run('{manage_py} flush --noinput'.format( 
manage_py=_get_manage_dot_py(env.host) 


)) 


def create_session_on_server(email): 
session key = run('{manage_py} create session {email}'.format( 
manage_py=_get_manage_dot_py(env.host), 
email=email, 
)) 


print(session_key) 


充分 理解 了 吗 ? 我 们 定义 了 一 个 函数 ， 在 数据 库 中 创建 会 话 。 如 果 检 测 到 在 本 地 运行 ， 直 
接 调用 这 个 函数 。 如 果 在 服务 器 中 运行 ， 需 要 做 一 些 额外 的 工作 : 使 用 subprocess 模块 通 
过 fab 命令 得 到 Fabric， 以 便 在 服务 器 中 运行 管理 命令 ， 调 用 相同 的 函数 。 

要 不 我 们 使 用 ASCII 图 表 来 表示 怎么 样 ? 
在 本 地 : 


MyListsTest 
.Create_pre_authenticated_session --> .management.commands.create_session 
.Create_pre_authenticated_session 



































在 过 渡 服 务 器 中 : 
MyListsTest 
.Create_pre_authenticated_session .management .commands .create_session 
.Create_pre_authenticated_session 
| 
\I/ /人 
| 
server_tools 
.Create_session_on_server run manage.py create_session 
| /Il\ 


\I/ | 
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subprocess.check output --> fab 


--> fabfile.create_ session on_server 


不 论 如 何 ， 看 一 下 这 么 做 是 否 可 行 。 首先， 在 本 地 运行 测试 ， 确 认 没 有 造成 任何 破坏 : 





$ python3 manage.py test functional._: 


Ei] 
OK 





tests.test my_lists 


然后 在 服务 器 中 运行 。 先 把 代码 推送 到 服务 器 中 : 





$ git push # 要 先 提交 改动 
$ cd deploy_tools 
$ fab deploy --host=superlists-stagi 


ng.ottg.eu 


再 运行 测试 。 注 意 ， 现 在 指定 Liveserver 参数 的 值 时 可 以 包含 elspeth@: 


$ python3 manage.py test functional_ 
--liveserver=elspeth@superlists-stag 
Creating test database for alias 'de 
[superlists-staging.ottg.eu] Executi 


tests.test_my_lists \ 
ing.ottg.eu 

fault'... 

ng task 'reset_database' 


~/sites/superlists-staging.ottg.eu/source/manage.py flush --noinput 


[superLists-staging.ottg.eu] out: Sy 
[superlists-staging.ottg.ey] out: Cr 


[..,] 


ncing. . . 
eating tables ... 


Ran 1 test in 25.701s 


OK 


看 起 来 没 问 题 。 还 可 以 运行 全 部 测试 确认 一 下 : 


$ python3 manage.py test functionalL_ 
--liveserver=elspeth@superlists-stag 
Creating test database for alias 'de 
[superlists-staging.ottg.eu] Executi 





tests \ 

ing.ottg.eu 

fault'... 

ng task 'reset_database 


1 























| 
Ran 7 tests in 89.494s 
OK 
Destroying test database for alias 'default'... 
太 棒 了 ! 
我 展示 了 管理 测试 数据 库 的 一 种 方法 ， 你 也 可 以 试验 其 他 方式 。 例 如 ， 使 用 
MySQL 或 Postgres， 可 以 打开 一 个 SSH 隧道 连接 服务 器 ， 使 用 端口 转发 直 
接 操 作 数 据 库 。 然 后 修改 settings .DATABASES， 让 功能 测试 使 用 隧道 连接 的 
端口 和 数据 库 交 互 。 
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警告 : 小 心 ， 不 要 在 线 上 服务 器 中 运行 测试 


我 们 现在 遇 到 一 件 危 险 的 事 ， 因 为 编写 的 代码 能 直接 影响 服务 器 中 的 数据 库 。 一 定 要 
非常 非常 小 心 ， 别 在 错误 的 主机 中 运行 功能 测试 ， 把 生产 数据 库 清 空 


可 以 考虑 使 用 一 些 安全 防护 措施 。 例 如 ， 把 过 渡 环 境 和 生产 环境 放 在 不 同 的 服 
器 中 ， 而 且 不 同 的 服务 器 使 用 不 同 的 口令 认证 密 钥 对 。 


在 生产 环境 的 数据 副本 中 运行 测试 也 有 同样 的 危险 ,我 就 曾经 不 小 心 重复 给 客户 发 送 
了 发 票 。 这 是 前 车 之 鉴 啊 。 


17.4 ”集成 日 志 相 关 的 代码 


结束 本 章 之 前 ， 我 们 要 把 日 志 相 关 的 代码 集成 到 应 用 中 。 把 输出 日 志 的 代码 放 在 那儿 ， 并 
且 纳 入 版 本 控制 ， 有 助 于 调试 以 后 遇 到 的 登录 问题 。 毕 况 有 些 人 不 怀 好 意 。 


先 把 Gunicorn 的 配置 保存 到 deploy_tools 文件 夹 里 的 临时 文件 中 : 




















deploy tools/eunicorn-upstart.template.conf 


[ss 
chdir /home/elspeth/sites/SITENAME/source 


exec ../virtualenv/bin/gunicorn \ 
--bind unix:/tmp/SITENAME.socket \ 
--access-logfile ../access.log \ 
--error-logfile ../error.log \ 
superlists.wsgi:application 


使 用 可 继承 的 日 志 配 置 

前 面 调 用 logging.warning 时 ， 使 用 的 是 根 日 志 记 录 器 。 一 般 来 说 ， 这 么 做 并 不 好 ， 因 为 
第 三 方 模块 会 干扰 根 日 志 记 录 器 。 一 般 的 做 法 是 使 用 以 所 在 文件 命名 的 日 志 记 录 器 ， 使 用 
下 面 的 代码 : 














7 











Logger = logging.getLogger(_name ) 





日 志 的 配置 可 以 继承 ， 所 以 可 以 为 顶层 模块 定义 一 个 父 日 志 记录 器 ， 让 其 中 的 所 有 Python 
模块 都 继承 这 个 配置 。 


在 settings.py 中 为 所 有 应 用 设置 日 志 记 录 器 的 方式 如 下 所 示 : 





superlists/settings.py 
LOGGING = { 
'version': 1， 
'disable existing_ loggers': False, 
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'handlers': { 
'console': { 
'level': 'DEBUG', 


'class': 'logging.StreamHandler', 
}, 
]， 
'loggers': { 
'django': { 
'handlers': ['console'], 
}, 
'accounts': { 
'handlers': ['console'], 
}s 
'lists': { 
'handlers': ['console'], 
5 
]， 


'root': {'level': 'INFO'}, 
} 


现在 ，accounts.models、accounts.views 和 accounts.authentication 等 应 用 都 从 父 日 志 记 录 器 


accounts 中 继承 Logging.StreamHandler。 


不 过 ， 受 限于 Django 的 项 目 结构 ， 无 法 为 整个 项 目 定义 一 个 顶层 日 志 记 录 器 (除非 使 用 


根 日 志 记 录 器 ) ， 所 以 必须 分 别 为 每 个 应 用 定义 各 自 的 日 志 记录 器 。 
为 日 志 行为 编写 测试 的 方法 如 下 所 示 : 


accounts/tests/test_authentication.py (ch171023) 


import logging 


[iam] 


@patch('accounts.authentication.requests.post') 
class AuthenticateTest(TestCase): 


[...] 


def test logs_non_ okay_responses_from persona(self, mock_post): 
response_json = { 
'status': 'not okay', 'reason': 'eg, audience mismatch' 
} 
mock_post.return_value.ok = True 
mock_post.return_value.json.return_value = response_json #@ 


Logger = logging.getLogger('accounts.authentication') #@ 
with patch.object(logger, 'warning') as mock_Log_warning: #@ 
self.backend.authenticate('an assertion') 


mock_log_warning.assert_called_once with( 
'Persona says no. Json was: {}'.format(response_json) #@ 


) 














@ 给 测试 提供 一 些 数据 ， 触 发 日 志 记 录 器 。 
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@ 获取 正在 济 试 的 这 个 模块 的 日 志 记 录 器 


@ 使 用 patch.object 临时 模拟 这 个 日 志 记 录 器 的 warning 函数 。 使 用 with 的 目的 是 于 
个 双 件 作为 测试 目标 函数 的 上 下 文 管理 器 。 


后 可 以 使 用 这 个 驭 件 声明 断言 。 


[ey 





(8 











测试 的 结果 为 : 


AssertionError: Expected 'warning' to be called once. Called 0 times . 
试 一 下 ， 确 保 测 试 了 我 们 想 测 试 的 行为 : 


accounts/authentication.py (ch171024) 


import logging 
Logger = logging.getLogger(_ name ) 


[Ess] 
if response.ok and response.json()['status'] == 'okay': 
| 
else: 
Logger .warning('foo') 
得 到 了 预期 的 失败 : 


AssertionError: Expected call: warning("Persona says no. Json was: {'status': 
"not okay', 'reason': 'eg, audience mismatch'}") 
Actual call: warning('foo') 





然后 使 用 真正 的 实现 方式 : 


accounts/authentication.py (ch171025) 


else: 
logger .warning( 
'Persona says no. Json was: {}'.format(response.json()) 


) 


$ python3 manage.py test accounts 
Ex] 
Ran 15 tests in 0.033s 


OK 


现在 如 果 想 为 response.ok != True 指定 不 同 的 错误 消息 ， 或 者 有 其 他 需求 ， 可 以 轻易 想 
出 如 何 编写 更 多 的 测试 。 
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17.5 “小 结 


至 此 ， 已 经 让 测试 国 件 既 可 以 在 本 地 使 用 也 能 在 服务 器 中 使 用 ， 还 设 定 了 更 牢靠 的 日 志 
配置 。 


























不 过 ， 在 部 署 线 上 网 站 之 前 ， 最 好 为 用 户 提供 他 们 真正 想 要 的 功能 
“My Lists” 页 面 中 汇总 用 户 的 清单 。 


下 一 章 介绍 如 何在 


























固件 和 日 志 
。 谨慎 去 除 功能 测试 中 的 重复 
每 个 功能 测试 没 必 要 都 测试 应 用 的 全 部 功能 。 在 这 一 章 遇 到 的 情况 中 ， 我 们 想 避 免 
在 每 个 需要 已 认证 用 户 的 功能 测试 中 走 一 遍 整 个 登录 流程 ， 所 以 使 用 测试 固件 “ 作 
状 ”， 跳 过 登录 过 程 。 在 功能 测试 中 还 可 能 需要 跳 过 其 他 过 程 。 不 过 ， 我 要 提醒 一 
下 ， 功 能 测试 的 目的 是 为 了 捕获 应 用 不 同 部 分 之 间 交 互 时 的 异常 表现 ， 所 以 去 除 重 
复 时 一 定 要 谨慎 ， 别 过 火 了 。 


。 测试 固件 
测试 固件 指 运 行 测试 之 前 要 提前 准备 好 的 测试 数据 。 一 般 使 用 一 些 数 据 填充 数据 
库 ， 不 过 如 前 所 示 (创建 浏览 器 的 cookie) ， 也 会 涉及 到 其 他 准备 工作 。 


。 避免 使 用 JSON 固 件 
Django 提供 的 dumpdata 和 loaddata 等 命令 ， 简 化 了 把 数据 库 中 的 数据 导出 为 
JSON 格式 的 操作 ， 也 可 以 轻易 的 使 用 JSON 格式 数据 还 原 数 据 库 。 大 多 数 人 部 不 
建议 使 用 这 种 固件 ， 因 为 数据 库 模 式 发 生变 化 后 这 种 固件 很 难 维护 。 请 使 用 ORML， 
或 者 factory_boy (https://factoryboy.readthedocs.org/) 这 类 工具 。 


。 固件 也 要 在 远程 服务 器 中 使 用 
在 本 地 运行 测试 ， 使 用 LiveServerTestCase 即 可 以 轻松 通过 Django ORM 与 测试 数 
据 库 交互 。 与 过 渡 服 务 器 中 的 数据 库 交 互 就 没 这 么 简单 了 。 解 决 方法 之 一 是 使 用 
Django 管理 命令 ， 如 前 文 所 示 。 不 过 也 可 以 小 心 探索 ， 找 到 自己 合用 的 方法 。 


。 使 用 以 所 在 模块 命名 的 日 志 记 录 器 
根 日 志 记 录 器 是 一 个 全 局 对 象 ，Python 进程 中 加 载 的 所 有 库 都 能 访问 ， 所 以 这 个 
日 志 记 录 器 不 完全 在 你 的 控制 之 中 。 因 此 要 使 用 Logging.getLogger(_name__) 获 
取 一 个 相对 模块 唯一 的 记录 器 ， 而 且 这 个 记录 器 继承 自 设 定 的 顶层 配置 。 


。 测试 重要 的 日 志 消 息 
已 经 见识 到 ， 日 志 消 息 对 于 调试 生产 环境 中 的 问题 十 分 重要 。 如 果菜 个 日 志 消 息 很 
重要 ， 必 须 保留 在 代码 中 ， 或 许 也 有 必要 测试 。 根 据 经 验 ， 比 Logging.INF0 等 级 高 
的 日 志 消息 都 要 测试 。 在 测试 目标 模块 所 用 的 日 志 记录 器 上 使 用 patch.object， 有 
助 于 简化 上 日志 消息 的 单元 测试 。 
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第 18 章 
完成 “My Lists” 页 面 . 
由 外 而 内 的 TDD 





本 章 我 要 介绍 一 种 技术 ， 叫 “由 外 而 内 ”的 TDD。 一 直 以 来 ,我 们 几乎 都 在 使 用 这 种 技 
术 。 双 循 环 ”TDD 流程 就 体现 了 由 外 而 内 的 思想 一 一 先 编写 功能 测试 ， 然 后 再 编写 单元 
测试 ， 基 实 就 是 从 外 部 设计 系统 ， 再 分 层 编 写 代 码 。 现 在 我 要 明确 提出 这 个 概念 ， 再 讨论 
其 中 涉及 的 常见 问题 。 


18.1 对立 技 术 : “由 内 而 外 ” 


“由 外 而 内 ”的 对 立 技术 是 “由 内 而 外 ， 接 触 TDD 之 前 ， 大 多 数 人 都 赁 直觉 选择 后 者 。 
提出 一 个 设计 想法 之 后 ， 有 时 会 自然 而 然 地 从 最 内 部 、 最 低层 的 组 件 开始 实现 。 
































例如 ， 就 我 们 现在 面 对 的 问题 而 言 ， 要 想 为 用 户 提 供 一 个 “My Lists” 页 面 显 示 已 经 保存 
的 清单 ， 我 们 首先 会 迫不及待 地 在 List 模型 中 添加 owner 属性 ， 因 为 根据 需求 推断 ， 显 
然 需要 这 样 一 个 属性 。 之 后 ， 借 助 这 个 新 属性 修改 外 层 代 码 ， 例 如 视图 和 模板 ， 最 后 添加 
URL 路 由 ， 指 向 新 视 












































这 么 做 感觉 更 自然 ， 因 为 所 用 的 代码 从 来 不 会 依赖 尚未 实现 的 功能 。 内 层 的 一 切 都 是 构建 
外 层 的 坚实 基础 。 


不 过 ， 像 这 样 由 内 而 外 的 工作 方式 也 有 人 缺点。 
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18.2 为 什么 选择 使 用 “由 外 而 内 ” 


由 内 而 外 的 技术 最 明显 的 问题 是 它 迫 使 我 们 抛 开 TDD 流程 。 功 能 测试 第 一 次 失败 可 能 是 
因为 缺少 URL 路 由 ， 但 我 们 决定 忽略 这 一 点 ， 先 为 数据 库 模 型 对 象 添加 属性 。 


我 们 可 能 已 经 在 脑海 中 构思 好 了 内 层 的 模样 ， 而 且 这 些 想法 往往 都 很 好 ， 不 过 这 些 都 是 对 
真实 需求 的 推测 ， 因 为 还 未 构造 使 用 内 层 组 件 的 外 层 组 件 。 

这 么 做 可 能 会 导致 内 层 组 件 大 党 统 ， 真 ` 仅 浪费 了 时 间 ， 还 把 
项 目 变 得 更 为 复杂 。 另 一 种 常见 的 问题 是 ， 创 建 内 层 组 件 使 用 的 APT 咎 看 起 来 对 内 部 设计 
言 很 合适 ， 但 之 后 会 发 现 并 不 适用 于 外 层 组 件 。 更 糟 的 是 ， 最 后 你 可 能 会 发 现 内 层 组 件 
完全 无 法 解决 外 层 组 件 需要 解决 的 问题 。 


与 此 相反 ， 使 用 由 外 而 内 的 工作 方式 ， 可 以 在 外 层 组 件 的 基础 上 构思 想 从 内 层 组 件 获 取 的 
最 佳 API。 下 面 以 实例 说 明 如 何 使 用 由 外 而 内 技术 。 


18.3 “My Lists” 页 面 的 功能 测试 


编写 下 面 这 个 功能 测试 时 ， 我 们 从 能 接触 到 的 最 外 层 开始 (表现 层 )， 然 后 是 视图 函数 
(或 叫 “ 控 制 器 ") ， 最 后 是 最 内 层 ， 在 这 个 例子 中 是 模型 代码 。 



































了 














既然 create_pre_authenticated_session 图 数 可 以 正常 使 用 ， 那 么 就 可 以 直接 用 来 编写 针 
对 “My Lists” 页 面 的 功能 测试 : 


functional tests/test my lists.py 


def test logged in users_lists are_ saved as my_lists(self): 
# 伊 迪 丝 是 已 登录 用 户 


seLf .create_pre_authenticated_session('edithQexampLe.com ') 























# 她 访问 首页 ,新 建 一 个 清单 

seLf .browser .get(seLf.server_UrL) 

self.get item input_ box().send_ keys('Reticulate splines\n') 
self.get item input_ box().send_ keys('Immanentize eschaton\n') 
first_ list url = self.browser.current_url 


# 她 第 一 次 看 到 My Lists 链 接 
self.browser .find_ element_ by_link text('My Lists').click() 


# 她 看 到 这 个 页 面 中 有 她 创建 的 清单 

# 而 且 清 单 根据 第 一 个 待 办 事项 命名 

self.browser .find element_ by_link_ text('Reticulate splines').click() 
self.assertEqual(self.browser.current_url, first list_url) 



































# 她 决定 再 建 一 个 清单 试 试 
seLf .browser .get(self.server_url) 
self.get item input_box().send_keys('Click cows\n') 
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second_list url = self.browser.current_url 





# 在 My Lists 页 面 ,这 个 新 建 的 清单 也 显示 出 来 了 

self.browser.find element by_link_ text('My Lists').click() 
self.browser.find element by_link_ text('Click cows').click() 
self.assertEqual(self.browser.current_url, second_ list_url) 








# 她 退出 后 ,My Lists 链 接 不 见 了 
seLf .browser .fitnd_eLement_by _id('id logout').click() 
seLf .assertEquaL( 

seLf .browser .find_eLements_by_Link_text('My Lists' )， 


[] 





) 
运行 这 个 测试 ， 看 到 的 第 一 个 错误 应 该 像 下 面 这 样 : 


selenium.common.exceptions.NoSuchElementException: Message: 'Unable to locate 
element: {"method":"link text","selector":"My Lists"}' ; Stacktrace: 


18.4 外 层 : 表现 层 和 模板 


目前 ， 这 个 测试 失败 ， 报 错 无 法 找到 “My Lists” 链 接 。 这 个 问题 可 以 在 表现 层 ， 即 base. 
html 模板 里 的 导航 条 中 解决 。 最 少量 的 代码 改动 如 下 所 示 : 


lists/templates/base.html (ch181002-1) 


{% if user.email %} 
<ul class="nav navbar-nav "> 
<li><a href="#">My Lists</a></\li> 
</ul> 
<a class="btn navbar-btn navbar-right" id="id logout" [...] 





显然 ， 这 个 链接 没 指向 任何 页 面 ， 能 解决 这 个 问题 ， 得 到 下 一 个 失败 消息 : 











self.browser.find element by_link_ text('Reticulate splines').click() 
[i481] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"link text","selector":"Reticulate splines"}' ; Stacktrace: 








失败 消息 指出 要 构建 一 个 页 面 ， 用 标题 列 出 一 个 用 户 的 所 有 清单 。 先 从 简单 的 开始 一 一 一 
个 URL 和 一 个 占 位 模板 。 


可 以 再 次 使 用 由 外 而 内 技术 ， 先 从 表现 层 开 始 ， 只 写 上 地 址 ， 基 他 什么 都 不 做 : 












































lists/templates/base.html (ch181002-2) 


<ul class="nav navbar-nav"> 
<li><a href="{% url 'my_lists' user.email %}">My Lists</a></li> 
</ul> 
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18.5 ”下 移 一 层 到 视图 函数 〈 控 制 器 ) 
这 样 改 还 是 会 得 到 模板 错误 ， 所 以 要 从 表现 层 和 URL 层 下 移 ， 进 入 控制 器 层 ， 即 Django 
中 的 视图 函数 。 


一 如 既往 ， 先 写 测试 











lists/tests/test views.py (ch181003) 
class MyListsTest(TestCase): 
def test my_lists url_renders my_lists template(self): 


response = self.client.get('/lists/users/a@b.com/') 
self.assertTemplateUsed(response, 'my_lists.html') 


得 到 的 测试 结果 为 : 
AssertionError: No templates used to render the response 


然后 修正 这 个 问题 ， 不 过 还 在 表现 层 ， 更 准确 地 说 是 urls.py: 





























lists/urls.py 


urlpatterns = patterns('', 
url(r'^(\d+)/$', 'lists.views.view list', name='Vview_list'), 
url(r'^new$', 'lists.views.new_list', name='new_list'), 
url(r'^users/(.+)/$', 'lists.views.my_lists', name='my_lists'), 


) 
修改 之 后 会 得 到 一 个 测试 失败 消息 ， 告 诉 我 们 移 到 下 一 层 之 后 要 做 什么 : 


django.core.exceptions.ViewDoesNotExist: Could not import lists.views.my_lists. 
View does not exist in module lists.views. 


从 表现 层 移 到 视图 层 ， 再 定义 一 个 最 简单 的 占 位 视图 : 








lists/views.py (ch181005) 


def my_lists(request, email): 
return render(request, 'my_lists.html') 


以 及 一 个 最 简单 的 模板 : 
lists/templates/my_ lists.html 
{% extends 'base.html' %} 
{% block header_ text %}My Lists{% endblock %} 


现在 单元 测试 通过 了 ， 但 功能 测试 之 无 进展 ， 报 错 说 “My Lists” 页 面 没 有 显示 清单 。 功 
能 测试 希望 这 些 清单 可 以 点 击 ， 而 且 以 第 一 个 待 办 事项 命名 : 


























selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"link text","selector":"Reticulate splines"}' ; Stacktrace: 





18.6 ”使 用 由 外 而 内 技术 ， 再 让 一 个 测试 通过 


仍然 使 用 功能 测试 驱动 每 一 步 的 开发 工作 。 





再 次 从 外 层 开 始 ， 编 写 模板 代码 ， 让 “My Lists” 页 面 实现 设想 的 功能 。 现 在 ， 要 指定 希 


望 从 低层 获取 的 API。 
18.6.1 快速 重组 模板 的 继承 层级 


基 模 板 目前 设 有 地 方 放置 新 内 容 了 ， 而 且 “My Lists” 页 画 








不 需要 新 建 待 办 事项 表单 ， 所 

















以 把 表单 放 到 一 个 块 中 ， 需 要 时 才 显 示 : 








lists/templates/base.html (ch181007-1) 


<div class="text-center"> 


<h1i>{% block header_text %}{% endblock %}</hi> 


{% block list_form %} 
<form method="POST" action="{% block form action %}{% endblock %}"> 
{{ form.text }} 
{% csrf_token %} 
{% if form.errors %} 
<div class="form-group has-error"> 
<div class="help-block">{{ form.text.errors }}</div> 
</div> 
{% endif %} 
</form> 
{% endblock %} 


</div> 


lists/templates/base.html (ch181007-2) 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
{% block table %} 
{% endblock %} 
</div> 
</div> 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
{% block extra_content %} 
{% endblock %} 
</div> 
</div> 


</div> 


<script src="http://code.jquery.com/jquery.min.js"></script> 


ee] 
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18.6.2 ”使 用 模板 设计 API 
同时 ， 在 my_lists.html 中 覆盖 List_form 块 ， 把 块 中 的 内 容 请 空 : 
lists/templates/my_lists.html 


{% extends 'base.html' %} 
{% block header_text %}My Lists{% endblock %} 
{% block list_form %}{% endblock %} 


然后 只 在 extra_content 块 中 编写 代码 : 





lists/templates/my lists.html 
[...] 


{% block list_form %}{% endblock %} 


{% block extra_content %} 
<h2>{{ owner.email }}'s lists</h2> © 
<ul> 
{% for list in owner.list set.all %} @ 
<li><a href="{{ list.get absolute url }}">{{ list.name }}</a></li> © 


{% endfor %} 
</ul> 
{% endblock %} 
在 这 个 模板 中 我 们 做 了 几 个 设计 决策 ， 这 会 对 内 层 代码 产生 一 定 影响 : 
@ 需要 一 个 名 为 owner 的 变量 ， 在 模板 中 表示 用 户 。 
@ 想 使 用 owner.list_set.all 遍历 用 户 创建 的 清单 (我 碰巧 知道 Django ORM 提供 了 这 个 
属性 ) 。 


@ 想 使 用 List,name 获取 清单 的 名 字 ， 目 前 清单 以 其 中 的 第 一 个 待 办 事项 命名 。 























由 外 而 内 的 TDD 有 时 叫 作 “一 厢 情 愿 式 编程 ”， 我 想 你 能 看 出 为 什么 。 我 
们 先 编写 高 层 代 码 ， 这 些 代码 建立 在 设想 的 低层 基础 之 上 ， 可 是 低层 尚未 








再 次 运行 功能 测试 ， 确 认 没 有 造成 任何 破坏 ， 同 时 查看 有 无 进展 
$ python3 manage.py test functional_tests 
[aad] 


selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 


element: {"method":"link text","selector":"Reticulate splines"}' ; Stacktrace: 





FAILED (errors=1) 
虽然 没 进展 ， 但 至 少 没 造成 任何 破坏 。 该 提交 了 : 
$ git add lists 


$ git diff --staged 
$ git commit -m "url, placeholder view, and first-cut templates for my_lists" 


18.6.3” 移 到 下 一 层 : 视图 向 模板 中 传 入 什么 


lists/tests/test_ views.py (ch181011) 


from django.contrib.auth import get user_model 
User = get_user_model() 


| 
class MyListsTest(TestCase): 


def test my_lists url_renders my_lists_ template(self): 


[...] 


def test passes_correct owner_to_template(self): 
User .objects.create(email='wrong@owner .com') 
correct_user = User.objects.create(email='a@b.com') 
response = self.client.get('/lists/users/a@b.com/') 
self.assertEqual(response.context['owner'], correct_user) 


测试 结果 为 : 
KeyError: ' owner， 
那 就 这 么 修改 ， 


lists/views.py (ch181012) 


from django.contrib.auth import get user_model 
User = get_user_model() 


长。 


def my_lists(request, email): 
owner = User.objects.get(email=email) 
return render(request, 'my_lists.html', {'owner': owner}) 


这 样 修改 之 后 ， 新 测试 通过 了 ， 但 还 古 能 看 到 前 一 个 测试 导致 的 错误 。 只 需 在 这 个 测试 中 
添加 一 个 用 户 即 可 : 


lists/tests/test_ views.py (ch181013) 


def test my_lists url_renders my_lists template(self): 
User .objects.create(email='a@b.com') 


[ee] 
现在 测试 全 部 通过 : 





OK 
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18.7 ”视图 层 的 下 一 个 需求 : 新 建 清单 时 应 该 记录 


属 主 


下 移 到 模型 层 之 前 ， 视 图 层 还 有 一 部 分 代码 要 用 到 模型 ， 如 果 当 前 用 户 已 经 登录 网 站 ， 
要 一 种 方式 把 新 建 的 清单 指派 给 一 个 属 主 。 


初期 编写 的 测试 如 下 所 示 : 























lists/tests/test_ views.py (ch181014) 
from django.http import HttpRequest 


[i :1] 
from lists.views import new_list 
[i 


class NewListTest(TestCase): 


[...] 


def test list owner_is_ saved if user_ is authenticated(self): 
request = HttpRequest() 
request.user = User.objects.create(email='a@b.com') 
request.POST['text'] = 'new list item' 
new_list(request) 
List_ = List.objects.first() 
self.assertEqual(list_ .owner, request.user) 


文 个 测试 直接 调用 视图 函数 ， 而 且 手动 构造 了 一 个 HttpRequest 对 象 ， 因 为 这 么 写 测试 
稍微 简单 些 。 虽 然 Django 测试 客户 端 提供 了 辅助 函数 login， 但 在 外 部 认证 系统 中 用 起 
来 不 顺手 。 此 外 ， 还 可 以 手动 创建 会 话 对 象 (就 像 在 功能 测试 中 那样 ) ， 或 者 使 用 驭 件 ， 
不 过 我 觉得 使 用 这 两 种 方式 写 出 的 测试 代码 不 好 看 。 好 奇 的 话 ， 可 以 使 用 不 同方 式 编写 
这 个 测试 。 

这 个 测试 得 到 的 失败 消息 如 下 : 


AttributeError: 'List' object has no attribute 'owner' 





为 了 修正 这 个 问题 ， 可 以 尝试 编 写 如 下 代码 : 


lists/views.py (ch181015) 


def new_list(request): 

form = ItemForm(data=request.POST) 

if form.is_valid(): 
list = List() 
list_ .owner = request.user 
list_.save() 
form.save(for_list=list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', {"form": form}) 
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Ba 


但 这 个 视图 其 实 解 决 不 了 问题 ， 











为 还 不 知道 怎么 保存 清单 的 属 主 : 








self.assertEqual(list .owner, request.user) 
AttributeError: 'List' object has no attribute 'owner' 


抉择 时 刻 : 测试 失败 时 是 否 要 移入 下 一 层 
为 了 让 这 个 测试 通过 ， 就 目前 的 情况 而 言 ， 要 下 移 到 模型 层 。 但 还 有 一 个 失败 测试 ， 要 做 
的 工作 太 多 ， 现 在 下 移 可 不 明智 。 


可 以 采用 另 一 种 策略 ， 使 用 双 件 把 测试 和 下 层 组 件 更 明显 地 隔离 开 。 

一 方面 ， 使 用 驭 件 要 做 的 工作 更 多 ， 而 且 双 件 会 让 测试 代码 更 难 读 懂 。 另 一 方面 ， 如 果 应 
用 更 复杂 ， 外 部 和 内 部 之 间 的 分 层 更 多 ， 测 试 就 会 涉及 3 ~ 5 层 ， 在 深入 最 底层 实现 关键 
功能 之 前 ， 这 些 测 试 一 直 处 于 失败 状态 。 测 试 无 法 通过 ， 单 就 一 层 而 言 ， 我 们 就 无 法 确定 
它 是 否 能 正常 运行 ， 只 有 等 到 最 底层 实现 之 后 才 有 答案 。 


你 在 自己 的 项 目 中 有 可 能 也 会 遇 到 这 样 的 抉择 时 刻 。 两 种 方式 都 要 探讨 。 先 走 捷径 ， 放 任 
测试 失败 不 管 。 下 一 章 再 回 到 这 里 ， 探 讨 如 何 使 用 增强 隔离 的 方式 。 


















































下 面 做 次 提交 ， 并 且 为 这 次 提交 打上 标签 ， 以 便 下 一 章 能 找到 这 个 位 置 : 


7 











$ git commit -am"new_List view tries to assign owner but cant" 
$ git tag revisit_ this_point with_isolated_tests 


18.8 下 移 到 模型 层 


使 用 由 外 而 内 技术 得 出 了 两 个 需求 ， 需 要 在 模型 层 实现 ， 其 一 ， 想 使 用 .owner 属性 为 清单 
指派 一 个 属 主 ， 其 二 ， 想 使 用 API owner .list_set.all 获取 清单 的 属 主 。 























针对 这 两 个 需求 ， 先 编写 一 个 测试 : 


lists/tests/test_ models.py (ch181018) 


from django.contrib.auth import get user_model 
User = get user_model() 


EE] 
class ListModelTest(TestCase): 


def test get absolute url(self): 
[...] 


def test lists_can_have_owners(self): 
User = User.objects.create(email='a@b.com') 
list = List.objects.create(owner=user) 
self.assertIn(list , user.list set.all()) 
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又 得 到 了 一 个 失败 的 单元 测试 : 


list_ = List.objects.create(owner=user) 


[...] 


TypeError: 'owner' is an invalid keyword argument for this function 

















简单 些 ， 把 模型 写成 下 面 这 样 : 





from django.conf import settings 


[ee 


class List(models.Model): 
owner = models.ForeignKey(settings.AUTH_USER_MODEL) 











可 是 我 们 希望 属 主 可 有 可 无 。 明 确 表明 需求 比 含糊 其 辞 强 ， 而 且 测 试 还 可 以 作为 文档 ， 所 
以 再 编写 一 个 测试 








lists/tests/test models.py (ch181020) 


def test list owner_is optional(self): 
List.objects.create() # 不 该 抛 出 异常 





正确 的 模型 实现 如 下 所 示 : 


lists/models.py 


from django.conf import settings 


Ed 


class List(models.Model): 
owner = models.ForeignKey(settings.AUTH_USER_ MODEL, blank=True, null=True) 


def get_ absolute url(self): 
return reverse('view list', args=[self.id]) 


现在 运行 测试 ， 会 看 到 以 前 见 过 的 数据 库 错误 : 


return Database.Cursor .execute(self, query, params) 
django.db.utils.OperationalError: table lists_ list has no column named owner_id 


因为 需要 做 一 次 迁移 : 


$ python3 manage.py makemigrations 
Migrations for 'lists': 
0006_List_owner .py : 
- Add field owner to list 


快 成 功 了 ， 不 过 还 有 几 个 错误 : 


ERROR: test_redirects_after_POST (lists.tests.test views.NewListTest) 
[...] 

ValueError: Cannot assign "<SimpleLazyObject: 
<django.contrib.auth.models.AnonymousUser object at QOQx7f364795ef90>>": 





现在 


"List.owner" must be a "User" instance. 

ERROR: test saving a_POST_request (lists.tests.test views.NewListTest) 
Ex 

ValueError: Cannot assign "<SimpleLazyObject: 
<django.contrib.auth.models.AnonymousUser object at 0x7f364795ef90>>" : 
"List.owner" must be a "User" instance. 




















T 





回 到 视图 层 ， 做 些 清理 工作 。 注 意 ， 这 些 错 误 发 生 在 针对 new_tList 视图 的 测试 中 ， 


























而 且 用 户 没 有 登录 。 仅 当 用 户 登 录 后 才 应 该 保存 清单 的 属 主 。 在 第 16 章 中 定义 的 .is_ 
authenticated() 函数 现在 有 用 处 了 (用 户 未 登录 时 ，Django 使 用 AnonymousUser 类 表示 用 


a 








此 时 .is_authenticated() 函数 的 返回 值 始终 是 False) 











lists/views.py (ch181023) 


if form.is_ valid(): 
list = List() 
if request.user.is authenticated(): 
list_ .owner = request.user 
list_.save() 
form.save(for_list=list ) 





$ python3 manage.py test lists 
Creating test database for alias 'default'... 


Ran 39 tests in 0.237s 


OK 
Destroying test database for alias 'default'... 





现在 是 提交 的 好 时 机 : 


$ git add lists 
$ git commit -m"lists can have owners, which are saved on creation." 


最 后 一 步 : 实现 模板 需要 的 .name 属 性 
使 用 的 由 外 而 内 设计 方式 还 有 最 后 一 个 需求 ， 即 清单 根据 其 中 第 一 个 待 办 事项 命名 ， 














lists/tests/test_ models.py (ch181024) 


def test list name is first item text(self): 
List_ = List.objects.create() 
Item.objects.create(list=list , text='first item') 
Item.objects.create(list=list , text='second item') 
self.assertEqual(list .name, 'first item') 
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lists/models.py (ch181025) 


@property 
def name(self): 
return self.item set.first().text 








Python 中 的 @property 修饰 器 
如 果 你 没 见 过 @property 修饰 器 ， 我 告诉 你 ， 它 的 作用 是 把 类 中 的 方法 转变 成 与 属性 
一 样 ， 可 以 在 外 部 访问 。 
这 是 Python 语言 一 个 强大 的 特性 ， 因 为 很 容易 用 它 实现 “ 鸭 子 类 型 ”(duck typing ) ， 
无 需 修改 类 的 接口 就 能 改变 属性 的 实现 方式 。 也 就 是 说 ， 如 果 想 把 .name 改 成 模型 真 
正 的 属性 ， 在 数据 库 中 存储 文本 型 数据 ， 整 个 过 程 是 完全 透明 的 ， 只 要 兼顾 其 他 代码 ， 
就 能 继续 使 用 .name 获取 清单 名 ， 完 全 不 用 知道 这 个 属性 的 具体 实现 方式 。 


当然 了 ， 就 算 没 使 用 property 修饰 器 ， 在 Django 的 模板 语言 中 还 是 会 调用 .name 方 
法 。 不 过 这 是 Django 专 有 的 特性 ， 不 适用 于 一 般 的 Python 程序 。 





你 可 能 无 法 相信 ， 这 样 测 试 就 能 通过 了 ， 而 且 “My Lists” 页 面 (如 图 18-1) 也 能 使 用 了 。 
$ python3 manage.py test functional_tests 

| We 

Ran 7 tests in 93.819s 


OK 








了 To-Do lists - Mozilla Firefox 





Fle Edt Yew Hstory Bookmarks Tools Help 
| EY o-oo lists + 


< localhost:8081/listsiusers/edith%40email, com} Cc | 图 - coooe 月 县 俞 


Superlists My lists Logged in as edith@email com Log out 


My Lists 


edith@email.com's lists 


te splines 









x WebDriver 








18-1: 光彩 夺目 的 “My Lists” 页 面 (也 证 明 我 在 Windows 中 测试 过 ) 
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但 这 个 过 程 中 有 作弊 。 测 试 山羊 正 满怀 猜疑 。 实 现下 一 层 时 前 一 层 还 有 失败 的 测试 。 下 一 
章 要 看 一 下 增强 测试 隔离 性 如 何 编写 测试 。 





由 外 而 内 的 TDD 
。 由 外 而 内 的 TDD 
一 种 编写 代码 的 方法 ， 由 测试 驱动 ， 从 外 层 开始 (表现 层 ，GUI) ， 然 后 逐步 向 内 
层 移 动 ， 通 过 视图 层 或 控制 器 层 ， 最 终 达 到 模型 层 。 这 种 方法 的 理念 是 由 实际 需要 
使 用 的 功能 驱动 代码 的 编写 ,而 不 是 在 低层 猜测 需求 。 


。 一 厢 情 愿 式 编程 
由 外 而 内 的 过 程 有 时 也 叫 “ 一 厢 情 愿 式 编程 ”。 其 实 ， 任何 TDD 形式 都 涉及 一 厢 情 
愿 。 我 们 总 是 为 还 未 实现 的 功能 编写 测试 。 


。 由 外 而 内 技术 的 缺点 
由 外 而 内 技术 也 不 是 万 能 良药 。 这 种 技术 鼓励 我 们 关注 用 户 立 即 就 能 看 到 的 功能 ， 
但 不 会 自动 提醒 我 们 为 不 是 那么 明显 的 功能 编写 关键 测试 ， 例 如 安全 相关 的 功能 
你 自己 要 记得 编写 这 些 测试 。 
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第 19 章 


测试 隔离 和 “倾听 测试 的 心声 " 





前 一 章 对 视图 层 的 失败 单元 测试 放任 不 管 ， 进 入 模型 层 编写 更 多 的 测试 和 更 多 的 代码 ， 以 
便 让 这 个 测试 通过 。 

测试 侥幸 通过 了 ， 因 为 我 们 的 应 用 很 简单 。 我 要 强调 一 点 ， 在 复杂 的 应 用 中 ， 选 择 这 么 做 
是 很 危险 的 。 尚 未 确定 高 层 是 否 真正 完成 之 前 就 进入 低层 是 一 种 冒险 行为 。 























感谢 Gary Bernhardt， 他 看 了 前 一 章 的 草稿 ， 建 议 我 深入 介绍 测试 隔离 。 


确保 各 层 之 间 相 互 隔离 确实 需要 投入 更 多 的 精力 〈 以 及 更 多 可 怕 的 驭 件 )， 可 是 这 么 做 能 
促使 我 们 得 到 更 好 的 设计 。 本 章 就 以 实例 说 明 这 一 点 。 


19.1 重 温 抉择 时 刻 : 视图 层 依赖 于 尚未 编写 的 
模型 代码 

重 温 前 一 章 的 抉择 上 时刻， 那 时 new_List 视图 无 法 正常 运行 ， 因 为 清单 还 没有 .owner 属性 。 

我 们 要 逆转 时 光 ， 签 出 以 前 的 代码 ， 看 一 下 使 用 隔离 性 更 好 的 测试 效果 如 何 。 


























$ git checkout -b more-isolation # 为 这 次 实验 新 建 一 个 分 支 
$ git reset --hard revisit_ this_point_with_isolated._tests 


318 


失败 的 测试 是 下 面 这 个 : 


lists/tests/test views.py 


class NewListTest(TestCase): 


[3] 


def test list owner_is_ saved if user_ is authenticated(self): 
request = HttpRequest() 
request.user = User.objects.create(email="'a@b.com') 
request.POST['text'] = 'new list item' 
new_list(request) 
list = List.objects.first() 
self.assertEqual(list .owner, request.user) 


尝试 使 用 的 解决 方法 如 下 所 示 : 


lists/views.py 


def new_list(request): 

form = ItemForm(data=request.POST) 

if form.is valid(): 
list = List() 
list_ .owner = request.user 
list_.save() 
form.save(for_list=list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', {"form": form}) 








此 时 ， 这 个 视图 测试 是 失败 的 ， 因 为 还 未 编写 模型 层 : 











self.assertEqual(list_ .owner, request.user) 
AttributeError: 'List' object has no attribute 'owner' 








如 果 没 有 签 出 以 前 的 代码 并 还 原 lists/models.py， 就 不 会 看 到 这 个 错误 。 这 一 
步 一 定 要 做 。 本 章 的 目标 之 一 是 ， 看 一 下 是 否 真能 为 还 不 存在 的 模型 层 编写 
测试 。 








19.2 首先 尝试 使 用 驭 件 实 现 隔离 


清单 还 没有 属 主 ， 但 可 以 使 用 一 些 模拟 技术 让 视图 层 测试 认为 有 属 主 : 























lists/tests/test_views.py (ch191003) 
from unittest.mock import Mock, patch 
from django.http import HttpRequest 


from django.test import TestCase 


[...] 
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日 





@patch('lists.views.List') #0 
def test list owner_is_ saved if user_ is authenticated(self, mockList): 
mock_list = List.objects.create() #@ 
mock_list.save = Mock() 
mockList.return_vaLue = mock_list 
request = HttpRequest() 
request.user = User.objects.create() #@ 
request.POST['text'] = 'new List item' 


new_list(request) 


self.assertEqual(mock_list.owner, request.user) #@ 





@ 模拟 List 模型 的 功能 ， 获 取 视 图 创建 的 任何 一 个 清单 。 

















@ 为 视图 创建 一 个 真实 的 List 对 象 。List 对 象 必须 真实 ， 否 则 视图 尝试 保存 Iten 对 象 时 
会 遇 到 外 键 错误 〈 表 明 这 个 测试 只 是 部 分 隔离 ) 。 











@ 给 request 对 象 赋值 一 个 真实 的 用 户 。 





@ 现在 可 以 声明 断言 ， 判 断 清单 对 象 是 否 设 定 了 .owner 属性 。 
现在 运行 测试 应 该 可 以 通 


$ python3 manage.py test lists 
| We 

Ran 37 tests in 0.145s 

OK 


如 果 没 通过 ， 确 保 views.py 中 的 视图 代码 和 我 前 面 给 出 的 一 模 一 样 ， 使 用 的 是 List()， 而 


不 是 se 








使 用 驭 件 有 个 局 限 ， 必 须 按照 特定 的 方式 使 用 API。 这 是 使 用 双 件 对 象 要 做 
出 的 妥协 之 一 。 





使 用 ee 的 顺序 


这 个 测试 的 问题 是 ， 无 意 中 把 代码 写 错 也 可 能 侥幸 通过 测试 。 假 设 在 指定 属 主 之 前 不 小 心 
调用 了 save 方法 : 





lists/views.py 
if form.is_valid(): 
list = List() 
list_.save() 
list_ .owner = request.user 
form.save(for_list=list ) 
return redirect(list ) 
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按照 测试 现在 这 种 写法 ， 它 依旧 可 以 通过 : 





OK 





所 以 ， 不 仅 要 检查 指定 了 属 主 ， 还 要 确保 在 清单 对 象 上 调用 save 方法 之 前 就 已 经 指定 了 。 


使 用 驭 件 检 查 事件 发 生 顺 序 的 方法 如 下 。 可 以 模拟 一 个 函数 ， 作 为 侦 件 ， 检 查 调 用 这 个 侦 
件 时 周围 的 状态 : 




















lists/tests/test_views.py (ch191005) 


@patch('lists.views.List') 
def test list owner is saved if user_ is authenticated(self, mockList): 
mock_list = List.objects.create() 
mock_list.save = Mock() 
mockList.return_vaLue = mock_list 
request = HttpRequest() 
request.user = Mock() 
request.user.is_authenticated.return_value = True 
request.POST['text'] = 'new list item' 


def check_owner_assigned(): #0 
self.assertEqual(mock_list.owner, request.user) #@ 
mock_list.save.side effect = check_owner_assigned #@ 


new_list(request) 


mock_list.save.assert_called_ once _ with() #@ 





O@ @ 定义 一 个 函数 ， 在 这 个 函数 中 就 希望 先 发 生 的 事件 声明 断言 ， 即 检查 是 否 设 定 了 清单 
的 属 主 。 


@ ”把 这 个 检查 函数 赋值 给 后 续 事 件 的 side_effect 属性 。 当 视图 在 驭 件 上 调用 save 方法 
时 ， 才 会 执行 其 中 的 断言 。 要 保证 在 测试 的 目标 函数 调用 前 完成 此 次 赋值 。 


© ， 要 确保 设 定 了 side_effect 属性 的 函数 一 定 会 被 调用 ， 也 就 是 要 调用 .save() 
否则 断言 永远 不 会 运行 。 








使 用 驭 件 的 副作用 时 有 两 个 常见 错误 : 第 一 ，side_effect 属性 赋值 太 晚 ， 
也 就 是 在 调用 测试 目标 函数 之 后 才 赋 值 ， 第 二 ， 忘 记 检查 是 否 调用 了 引起 副 
作用 的 函数 。 说 “常见 "， 是 因为 撰写 本 章 时 我 多 次 同时 犯 了 这 两 个 错误 。 




















现在 ， 如 果 仍 然 使 用 前 面 有 错误 的 代码 ， 即 指定 属 主 和 调用 save 方法 的 顺序 不 对 ， 就 会 看 
到 如 下 错误 : 
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ERROR: test list owner is saved if user is authenticated 
(lists.tests.test_views.NewListTest) 
[sa] 

File "/workspace/superlists/lists/views.py", line 17, iin new_list 

list_.save() 
| We 

File "/workspace/superlists/lists/tests/test views.py", line 84, in 
check_owner_assigned 

self.assertEqual(mock_list.owner, request.user) 

AttributeError: 'List' object has no attribute 'owner' 


注意 看 这 个 失败 消息 ， 它 先 尝试 保存 ， 然 后 才 执 行 side_effect 属性 对 应 的 函数 。 
可 以 按照 下 面 的 方式 修改 ， 让 测试 通过 














lists/views.py 
if form.is_valid(): 
list = List() 
list_.owner = request.user 
list_ .save() 
form.save(for_list=list ) 
return redirect(list ) 





测试 结果 为 : 
OK 


但 是 ， 少 年 ， 这 个 测试 写 得 很 丑 ! 


19.3 ”倾听 测试 的 心声 : 丑陋 的 测试 表明 需要 重 构 


当 你 发 现 必须 像 这 样 编写 测试 ， 而 且 要 做 许多 工作 时 ， 很 有 可 能 表明 测试 试图 向 你 诉说 什 
么 。 准 备 测试 所 需 的 数据 用 了 10 行 代码 (用户 双 件 用 了 3 行 ， 请 求 对 象 又 用 了 4 行 ， 还 
有 3 行 设 定 副 作用 函数 )， 太 多 了 。 


这 个 测试 试图 告诉 我 们 ， 视 图 做 的 工作 太 多 了 ， 既 要 创建 表单 ， 又 要 创建 清单 对 象 ， 还 要 
决定 是 否 保存 清单 的 属 主 。 





















































前 面 已 经 说 过 ， 可 以 把 一 部 分 工作 交 给 表征 前 . 类 完成 ， 把 视图 变 :得 简 六 闻 和 且 易 于 理解 一 些 ， 为 
什么 要 在 视图 中 创建 清单 对 象 ? 或 许 ItemForm.save 能 代劳 ? 为 什么 视图 要 决定 是 否 保 存 
request.user ? 这 项 任务 也 可 以 交 给 表单 完成 。 


既然 要 把 更 多 的 任务 交 给 表单 ， 感 觉 应 该 为 这 个 表单 起 个 新 名 字 。 可 以 叫 它 NewListForm， 
因为 这 个 名 字 能 更 好 地 表明 它 的 作用 。 最 终 ， 视 图 或 许可 以 写成 这 样 吧 ，: 





二 | 
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lists/views.py 





# 先 不 输入 这 段 代码 ,只 是 假设 可 以 这 么 写 


def new_list(request): 
form = NewListForm(data=request.POST) 
if form.is_ valid(): 
list_ = form.save(owner=request.user) # 创建 List 和 Item 对 象 
return redirect(list ) 
else: 
return render(request, 'home.html', {"form": form}) 





这 样 多 简洁 ! 下 面 来 看 一 下 如 何 为 这 种 写法 编写 完全 隔离 的 测试 。 


[一 一 | 吾 六 让 * Fl < vl* 
19.4 ”以 完全 隔离 的 方式 重 写 视 图 测试 
首次 尝试 为 这 个 视图 编写 的 测试 组 件 集成 度 太 高 ， 数 据 库 层 和 表单 层 的 功能 完成 之 后 才能 
通过 。 现 在 使 用 另 一 种 方式 ， 提 高 测试 的 隔离 度 。 
19.4.1 为 了 新 测试 的 健全 性 ， 保 留 之 前 的 整合 测试 组 件 


把 NewListTest 类 重 名 为 NewListViewIntegratedTest， 再 把 尝试 使 用 驭 件 保 存 属 主 的 测试 
代码 删 掉 ， 换 成 整合 版 本 ， 而 且 暂 时 为 这 个 测试 方法 加 上 skip 修饰 器 : 














lists/tests/test_views.py (ch191008) 


import unittest 


|W 
class NewListViewIntegratedTest(TestCase): 


def test_saving_a_POST_request(self): 
Es] 


@unittest.skip 

def test list owner_is_ saved if user_ is authenticated(self): 
request = HttpRequest() 
request.user = User.objects.create(email='a@b.com') 
request.POST['text'] = 'new list item' 
new_list(request) 
list = List.objects.first() 
self.assertEqual(list .owner, request.user) 


你 听 说 过 “集成 测试 ”(integration test) 这 个 术语 吗 ” 想 知道 它 和 “整合 测 
试 ”(integrated test) 的 区 别 吗 ? 请 看 第 22 章 附注 栏 中 的 定义 。 
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$ python3 manage.py test lists 


[se 
Ran 37 tests in 0.139s 
OK 


19.4.2 ”完全 隔离 的 新 测试 组 件 

从 头 开始 编写 测试 ， 看 看 隔离 测试 能 否 驱 动 我 们 写 出 new_list 视图 的 替代 版 本 。 把 这 个 视 
图 命名 为 new_List2， 放 在 旧版 视图 旁边 。 写 好 之 后 ， 再 换 用 这 个 新 视图 ， 看 看 以 前 的 整 
合 测试 是 否 仍然 都 能 通过 。 
































lists/views.py (ch191009) 


def new_list(request): 


| | 
def new_list2(request): 
pass 
19.4.3 ”站 在 协作 者 的 角度 思考 问题 
重 写 测试 时 车 想 实 现 完全 隔离 ， 必 须 丢 掉 以 前 对 测试 的 认识 。 以 前 我 们 认为 视图 的 真正 作 














用 是 操作 数据 库 等 ， 现 在 则 要 站 在 协作 对 象 的 角度 ， 思 考 视图 如 何 与 之 交互 。 





站 在 新 的 角度 上 ， 发 现 视图 的 主要 协作 者 是 表单 对 象 。 所 以 ， 为 了 完全 掌控 表单 ， 以 及 按 
照 我 们 一 厢 情 愿 想 要 的 方式 定义 表单 的 功能 ， 使 用 驭 件 模拟 表单 。 














lists/tests/test_ views.py (ch191010) 


from lists.views import new_list, new_list2 


[...] 


Qpatch('Lists.views.NewListForm' ) #@ 
class NewListViewUnitTest(unittest.TestCase): #@ 


def setUp(self): 
seLf .request = HttpRequest() 
self.request.POST['text'] = 'new list item' #@ 


def test_ passes_POST_data to_ NewListForm(self, mockNewListForm): 
new_list2(self.request) 
mockNewListForm.assert_called_once_with(data=self.request.POST) #@ 














@ 使 用 Django 提供 的 TestCase 类 太 容 易 写 成 整合 测试 。 为 了 确保 写 出 纯粹 隔离 的 单元 测 
试 ， 只 能 使 用 unittest.TestCase。 














@ 模拟 NewListForm 类 (尚未 定义 )。 类 中 的 所 有 测试 方法 都 会 用 到 这 个 双 件 ， 所 以 在 类 
上 模拟 。 
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@ 在 setup 方法 中 手动 创建 了 一 个 简单 的 POST 请 求 ， 没 有 使 用 (大 过 整合 的 ) Django 测 
试 客户 端 。 











@ 然后 检查 视图 要 做 的 第 一 件 事 : 在 视图 中 使 用 正确 的 构造 方法 初始 化 它 的 协作 者 ， 即 
NewListForm， 传 人 的 数据 从 请 求 中 读 取 。 


























在 这 个 测试 的 结果 中 首先 会 看 到 一 个 失败 消息 ， 报 错 视图 中 还 没有 NewListForm。 











AttributeError: <module 'lists.views' from 
'/workspace/superlists/lists/views.py'> does not have the attribute 
'NewListForm’ 


先 编写 一 个 占 位 表单 类 : 








lists/views.py (ch191011) 


from lists.forms import ExistingListItemForm, ItemForm, NewListForm 


[ed 
以 及 : 


lists/forms.py (ch191012) 


class ItemForm(forms.models.ModelForm): 


Cad 


class NewListForm(object): 
pass 


class ExistingListItemForm(ItemForm): 


[...] 
看 到 了 一 个 真正 的 失败 消息 : 





AssertionError: Expected 'NewListForm' to be called once. Called 0 times. 
按照 如 下 的 方式 编写 代码 : 


lists/views.py (ch191012-2) 


def new_list2(request): 
NewListForm(data=request.POST) 


测试 结果 为 : 
$ python3 manage.py test lists 
[...] 


Ran 38 tests in 0.143s 
OK 


继续 编写 测试 。 如 果 表 单 中 的 数据 有 效 ， 要 在 表单 对 象 上 调用 save 方法 : 
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lists/tests/test views.py (ch191013) 


@patch('lists.views.NewListForm') 
class NewListViewUnitTest(unittest.TestCase): 


def 


def 


def 


setUp(self): 

self.request = HttpRequest() 
self.request.POST['text'] = 'new list item' 
self.request.user = Mock() 


test_passes_POST_data_ to_ NewListForm(self, mockNewListForm): 
new_list2(self.request) 
mockNewListForm.assert_called once with(data=self.request.POST) 


test_saves_form with owner_if_form valid(self, mockNewListForm): 
mock_form = mockNewListForm.return_value 
mock_form.is_valid.return value = True 

new_list2(self.request) 
mock_form.save.assert_ called_once with(owner=self.request.user) 








据 此 ， 可 以 写 出 如 下 视图 : 


lists/views.py (ch191014) 


def new_list2(request): 
form = NewListForm(data=request.POST) 
form.save(owner=request.user) 





如 果 表 单 中 的 数据 有 效 ， 让 视图 做 一 个 重 定向 ， 把 我 们 带 到 一 个 页 面 ， 查 看 表单 刚刚 创建 


的 对 象 。 所 以 要 模拟 视图 的 另 一 个 协作 者 

















redirect 国 数 : 


lists/tests/test views.py (ch191015) 


@patch('lists.views.redirect') #0 
def test_ redirects_ to _ form returned object if form valid( 
self, mock_redirect, mockNewListForm #@ 


) : 


mock_form = mockNewListForm.return_value 
mock_form.is valid.return value = True #@ 


response = new_list2(self.request) 


self.assertEqual(response, mock_redirect.return_value) #@ 
mock_redirect.assert called once with(mock_form.save.return_value) #@ 


@ 模拟 redirect 函数 ， 不 过 这 次 直接 在 方法 上 模拟 。 

@ patch 修饰 器 先 应 用 最 内 层 的 那个 ， 所 以 这 个 驭 件 在 mockNewListForn 之 前 传人 方法 。 
@ 指定 测试 的 是 表单 中 数据 有 效 的 情况 。 

@ 检查 视图 的 响应 是 否 为 redirect 函数 的 结果 。 

@ 然后 检查 调用 redirect 函数 时 传 入 的 参数 是 否 为 在 表单 上 调用 save 方法 得 到 的 对 象 。 
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六 


据 此 ， 可 以 编写 如 下 视图 : 








lists/views.py (ch191016) 


def new_list2(request): 
form = NewListForm(data=request.POST) 


list_ = form.save(owner=request.user) 
return redirect(list ) 
测试 结果 为 : 
$ python3 manage.py test lists 
Ls:] 
Ran 40 tests in 0.163s 
OK 


然后 测试 表单 提交 失败 的 情况 一 一 如 有 果 表 单 中 的 数据 无 效 ， 泻 染 首页 的 模板 ; 





lists/tests/test_views.py (ch191017) 


Q@patch('Lists.views.render ') 

def test_renders_home_ template with form if_form invalid( 
self, mock_render, mockNewListForm 

)s 
mock_form = mockNewListForm.return_value 
mock_form.is_valid.return_value = False 


response = new_list2(self.request) 
self.assertEqual(response, mock_render.return_value) 
mock_render .assert_called_once with( 


self.request, 'home.html', {'form': mock_form} 


) 
测试 的 结果 为 : 


AssertionError: <django.http.response.HttpResponseRedirect object at 
0x7f8d3f338a50> != <MagicMock name='render()' id='140244627467408'> 








在 驭 件 上 调用 断言 方法 时 一 定 要 运行 测试 ， 确 认 它 会 失败 。 因 为 输入 断言 函 
数 时 大 容易 出 错 ， 会 导致 调用 的 模拟 方法 没有 任何 作用 (我 会 写成 asssert_ 
called_once_with， 用 了 三 个 s。 你 自己 可 以 试 一 下 ! )。 

















故意 犯 个 错误 ， 确 保 测 试 全 面 : 


lists/views.py (ch191018) 


def new_list2(request): 
form = NewListForm(data=request.POST) 
list_ = form.save(owner=request.user) 
if form.is valid(): 
return redirect(list ) 
return render(request, 'home.html', {'form': form}) 





测试 隔离 和 “倾听 测试 的 心声 ” | 327 


日 





测试 本 不 应 该 通过 却 通过 了 ! 那 就 再 写 一 个 测试 : 


lists/tests/test views.py (ch191019) 


def test does not_ save_ if form invalid(self, mockNewListForm): 
mock_form = mockNewListForm.return_value 
mock_form.is_ valid.return value = False 
new_list2(self.request) 
self.assertFalse(mock_form.save.called) 


这 个 测试 会 失败 : 


self.assertFalse(mock_form.save.called) 
AssertionError: True is not false 








/说 





最 终 得 到 了 一 个 精简 的 视 





lists/views.py 


def new_list2(request): 
form = NewListForm(data=request.POST) 
if form.is_valid(): 
List_ = form.save(owner=request.user) 
return redirect(list ) 
return render(request, 'home.html', {'form': form}) 





测试 结果 为 : 


$ python3 manage.py test lists 


[a 
Ran 42 tests in 0.163s 
OK 


19.5 下 移 到 表单 层 


经 写 好 了 视图 函数 ， 这 个 视图 基于 设想 的 表单 NewItemForm， 而 且 这 个 表单 现在 还 不 存在 。 























需要 在 表单 对 象 上 调用 save 方法 创建 一 个 新 清单 ， 还 要 使 用 通过 验证 的 POST 数据 创建 一 
个 新 待 办 事项 。 如 果 直 接 使 用 ORM，save 方法 可 以 写成 这 & 样 ， 











class NewListForm(models.Form): 


def save(self, owner): 
list = List() 
if owner: 
list_.owner owner 
list_.save() 
item = Item() 
item.list = list_ 
item.text = self.cleaned data[ 'text'] 
item.save() 





这 种 实现 方式 依赖 于 模型 层 的 两 个 类 ， 即 Iten 和 List。 那 么 隔离 性 好 的 测试 应 该 怎么 写 呢 ? 
class NewListFormTest(unittest.TestCase): 


@patch('lists.forms.List') #0 
@patch('lists.forms.Item') #@ 
def test _ save_creates new_ list and_item from post_data( 
self, mockItem, mockList #@ 
和 
mock_item = mockItem.return_value 
mock_list = mockList.return_value 
user = Mock() 
form = NewListForm(data={'text': 'new item text'}) 
form.is_valid() #@ 


def check_item text_and_list(): 
self.assertEqual(mock_item.text, 'new item text') 
self.assertEqual(mock_item.list, mock_list) 
self.assertTrue(mock_list.save.called) 

mock_item.save.side effect = check_item text_and_list #@ 


form.save(owner=user) 


self.assertTrue(mock_item.save.called) #@ 


0 @ @ 为 表单 模拟 两 个 来 自 下 部 模型 层 的 协作 者 。 








9 必须 调用 is_valid() 方法 ， 这 样 表单 才 会 把 通过 验证 的 数据 存储 到 .cteaned_data 
字典 中 。 


9 使 用 side_effect 方法 确保 保存 新 待 办 事项 对 象 时 ， 使 用 已 经 保存 的 清单 ， 而 且 待 
办 事项 中 的 文本 正确 。 


© 一 如 既然 ,再 次 确认 调用 了 副作用 函数 。 








唉 ， 这 个 测试 写 得 好 丑 |! 


始终 倾听 测试 的 心声 : 从 应 用 中 删除 ORM 代 码 
测试 又 在 诉说 什么 :Django ORM 很 难 模 拟 ， 而 且 表 单 类 需要 较 深 入 地 了 解 ORM 的 工作 
方式 。 再 次 使 用 一 厢 情 愿 式 编程 ， 想 想 表 单 想 用 什么 样 的 简单 API 呢 ? 下 面 这 种 怎么 样 : 


























def save(seLf) : 
List.create new(first item text=self.cleaned data[ 'text']) 





又 冒 出 个 想法 : 要 不 在 List 类 ' 中 定义 一 个 辅助 函数 ， 封 装 保存 新 清单 对 象 及 相关 的 第 一 








注 1: 你 很 可 能 想 定义 一 个 单独 的 函数 ,但 是 放 在 类 中 有 利于 记 住 它 在 哪儿 。 更 重要 的 是 ， 还 能 表明 这 个 函 
数 的 作用 。 嗯 ， 我 保证 等 我 写 完 这 本 书 之 后 会 这 么 做 的 。 尖 锐 的 批评 就 此 打住 吧 ! 
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个 待 办 事项 这 部 分 逻辑 。 


那 就 先 为 这 个 想法 编写 测试 : 


lists/tests/test forms.py (ch191021) 


import unittest 
from unittest.mock import patch, Mock 
from django.test import TestCase 


from Lists.forms import ( 
DUPLICATE_ITEM_ERROR, EMPTY_LIST_ERROR, 
ExistingListItemForm, ItemForm, NewListForm 
) 
from lists.models import Item, List 


[...] 


class NewListFormTest(unittest.TestCase): 


@patch('lists.forms.List.create_ new') 
def test save_creates new_ list from post data_ if_user_not authenticated( 
self, mock_List create new 
这 
User = Mock(is authenticated=lambda: False) 
form = NewListForm(data={'text': 'new item text'}) 
form.is_valid() 
form.save(owner=user) 
mock_List create new.assert_called once with( 
first item text='new item text' 


) 


既然 已 经 测试 了 这 种 情况 ， 那 就 再 写 个 测试 检查 用 户 已 经 通过 认证 的 情况 吧 : 





lists/tests/test forms.py (ch191022) 


@patch('lists.forms.List.create new') 

def test save_creates new_ list with owner_if_user_authenticatd( 
self, mock_List create new 

Ys 
user = Mock(is_ authenticated=lambda: True) 
form = NewListForm(data={'text': 'new item text'}) 
form.is_valid() 
form.save(owner=user) 
mock_List create new.assert_called_ once with( 

first item text='new item text', owner=user 


) 





可 以 看 出 ， 这 个 测试 易 读 多 了 。 下 面 开 始 实现 新 表单 。 先 从 import 语句 开始 : 

















lists/forms.py (ch191023) 


from lists.models import Item, List 





此 时 驭 件 说 要 定义 一 个 占 位 的 create_new 方法 : 


AttributeError: <class 'lists.models.List'> does not have the _ attribute 
"Create_new' 


lists/models.py 
class List(models.Model): 


def get absolute url(self): 
return reverse('view list', args=[self.id]) 


def create_new(): 
pass 


几 步 之 后 ， 最 终 写 出 如 下 的 save 方法 : 


lists/forms.py (ch191025) 


class NewListForm(ItemForm): 


def save(self, owner): 
if owner.is_authenticated(): 
List.create new(first item text=self.cleaned data[ 'text'], owner=owner) 
else: 
List.create new(first item text=self.cleaned_ data[ 'text']) 


而 且 测 试 也 通过 了 : 
$ python3 manage.py test lists 


Ran 44 tests in 0.192s 
OK 





把 ORM 代码 放 到 辅助 方法 中 
从 编写 隔离 测试 的 过 程 中 我 们 学 会 了 一 项 技能 ,，“ORM 辅助 方法 ”。 


使 用 Django 的 ORM 可 以 通过 十 分 易 读 的 句法 (肯定 比 纯 SQL 好 得 多 ) 快速 完成 工 
作 。 但 有 些 人 喜欢 尽量 减少 应 用 中 使 用 的 ORM 代码 量 ， 尤 其 不 喜欢 在 视图 层 和 表单 
层 使 用 ORM 代码 。 


一 个 原因 是 ， 测 试 这 几 层 时 更 容易 。 另 一 个 原因 是 ， 必 须 定 义 辅助 方法 ， 这 样 能 更 清 
晰 地 表述 域 远 辑 。 请 把 对 比 下 面 这 两 段 代 码 : 


List_ = List() 

list_.save() 

item = Item() 

item.list = list_ 

item.text = self.cleaned data[ 'text'] 
item.save() 





List.create new(first item text=self.cleaned data[ 'text']) 








昌 
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辅助 方法 同样 可 用 于 读 写 查询 。 假 设 有 这 样 一 行 代码 : 
Book.objects.filter(in_print=True, pub_date lte=datetime.today()) 

和 如 下 的 辅助 方法 相 比 ， 就 好 就 坏 一 目 了 然 : 
Book.all_available_books() 

定义 辅助 方法 时 ， 可 以 起 个 适当 的 名 字 ， 表 明 它 们 在 业务 还 辑 中 的 作用 。 使 用 辅助 方 


法 不 仅 可 以 让 代码 的 条 理 变 得 更 清晰 ， 还 能 把 所 有 ORM 调用 都 放 在 模型 层 ， 因 此 整 
个 应 用 不 同 部 分 之 间 的 耦合 更 松散 。 








19.6 下 移 到 模型 层 


在 模型 层 不 用 再 编写 隔离 测试 了， 因为 模型 层 的 目的 就 是 与 数据 库 结合 在 一 起 工作 ， 所 以 
编写 整合 测试 更 合理 : 














Tr 














lists/tests/test models.py (ch191026) 
class ListModelTest(TestCase): 


def test get absolute url(self): 
List_ = List.objects.create() 
self.assertEqual(list .get absolute url(), '/lists/%d/' % (list_ .id,)) 


def test create new_creates list and first item(self): 
List.create new(first item text='new item text') 
new_item = Item.objects.first() 
self.assertEqual(new_item.text, 'new item text') 
new_list = List.objects.first() 
self.assertEqual(new_item.list, new_list) 

















测试 的 结果 为 : 
TypeError: create_new() got an unexpected keyword argument 'first item text' 


根据 测试 结果 ， 可 以 先 把 实现 方式 写成 这 样 : 








lists/models.py (ch191027) 
class List(models.Model): 


def get_ absolute url(self): 
return reverse('view list', args=[self.id]) 


@staticmethod 

def create new(first item text): 
List_ = List.objects.create() 
Item.objects.create(text=first item text, list=list ) 








注意 ， 一 路 走 下 来 ， 直 到 模型 层 ， 由 视图 层 和 表单 层 驱 动 ， 得 到 了 一 个 设计 良好 的 模型 ， 
但 是 List 模型 还 不 支持 属 主 。 


现在 ,测试 清单 应 该 有 一 个 属 主 。 添 加 如 下 测试 : 




















lists/tests/test models.py (ch191028) 


from django.contrib.auth import get user_model 
User = get_user_model() 


[...] 


def test_ create new_optionally_saves_owner(self): 
user = User.objects.create() 
List.create new(first item text='new item text', owner=user) 
new_List = List.objects.first() 
self.assertEqual(new_list.owner, user) 


既然 已 经 打开 这 个 文件 ， 那 就 再 为 owner 属性 编写 一 些 济 试 吧 : 


lists/tests/test_ models.py (ch191029) 
class ListModelTest(TestCase): 
[Eis] 


def test_lists_can_have_owners(self): 


List(owner=User()) # 不 该 抛 出 异常 
def test list owner_is optional(self): 
List().full_clean() # 不 该 抛 出 异常 


os 不 过 我 稍微 改 了 些 ， 不 让 它们 保存 对 象 。 因 为 
对 这 个 测试 而 言 ， 内 存 中 有 这 些 对 象 就 行 





省 





尽量 多 用 内 存 中 (未 保存 ) 的 模型 对 象 ， 这 样 测试 运行 得 更 快 。 








测试 的 结果 为 : 


$ python3 manage.py test lists 

Las:] 

ERROR: test_create_new_optionaLLy_saves_owner 

TypeError: create new() got an Unexpected keyword argument 'owner' 

Li] 

ERROR: test_lists_can_have_owners (lists.tests.test_ models.ListModelTest) 
TypeError: 'owner' is an invalid keyword argument for this function 

Liss] 

Ran 48 tests in 0.204s 

FAILED (errors=2) 


然后 按照 前 一 章 使 用 的 方式 实现 模型 
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lists/models.py (ch191030-1) 


from django.conf import settings 


[i 


class List(models.Model): 
owner = models.ForeignKey(settings.AUTH_USER_ MODEL, blank=True, null=True) 


[3:9 


此 时 ,测试 的 结果 中 有 各 种 完整 性 失败 ， 执 行 迁移 后 才能 解决 这 些 问 题 : 


执行 


django.db.utils.OperationalError: no such coLumn: lists_ list.owner_id 


FAILED (errors=28) 





迁移 后 再 运行 测试 ， 会 看 到 下 面 三 个 失败 : 











ERROR: test_create new_optionally_saves_owner 

TypeError: create new() got an unexpected keyword argument 'owner' 
[xsi] 

ValueError: Cannot assign "<SimpleLazyObject: 
<django.contrib.auth.models.AnonymousUser object at 0x7f5b2380b4e0>>": 
"List.owner" must be a "User" instance . 

ValueError: Cannot assign "<SimpleLazyObject: 
<django.contrib.auth.models.AnonymousUser object at 0x7f5b237a12e8>>": 
"List.owner" must be a "User" instance . 


先 处 理 第 一 个 失败 。 这 个 失败 由 create_new 方法 导致 : 


lists/models.py (ch191030-3) 


@staticmethod 
def create new(first item text, owner=None): 
list = List.objects.create(owner=owner) 


Item.objects.create(text=first item text, list=list ) 


回 到 视图 层 





视图 


啊 ， 原 来 是 因为 以 前 的 视 











层 以 前 的 两 个 整合 测试 失败 了 ， 怎 么 回 事 呢 ? 





ValueError: Cannot assign "<SimpleLazyObject: 
<django.contrib.auth.models.AnonymousUser object at QOx7fbadicb6c10>>": 
"List.owner" must be a "User" instance. 





/说 








没有 分 清 谁 才 是 清单 的 属 主 : 








lists/views.py 
if form.is_valid(): 
list = List() 
list_ .owner = request.user 
list_ .save() 





这 一 刻 才 意识 到 以 前 的 代码 没有 满足 需求 。 修 正 这 个 问题 ， 让 所 有 测试 都 通过 : 


lists/views.py (ch191031) 


def new_list(request): 
form = ItemForm(data=request.POST) 
if form.is valid(): 
list = List() 
if request.user.is authenticated(): 
list_ .owner = request.user 
list_.save() 
form.save(for_list=list ) 
return redirect(list ) 
else: 
return render(request, 'home.html', {"form": form}) 


def new_list2(request): 


[ei] 





整合 济 试 的 好 处 之 一 是 ， 可 以 捕获 这 种 无 法 轻易 预测 的 交互 。 我 们 筷 了 编写 
测试 检查 用 户 没 有 通过 验证 的 情况 ， 可 是 整合 测试 会 由 上 而 下 使 用 整个 组 
件 ， 最 终 模 型 层 出 现 了 错误 ， 提 醒 我 们 起 了 一 些 事 。 


























$ python3 manage.py test lists 
Ls] 


Ran 48 tests in 0.175s 
OK 


19.7 关键 时 刻 ， 以 及 使 用 模拟 技术 的 风险 


换 掉 以 前 的 视图 ， 使 用 新 视图 试 试 。 调 换 视 图 可 以 在 urls.py 中 完成 : 




















lists/urls.py 
[...] 
url(r'^new$', 'lists.views.new_ list2', name='new_list'), 
还 得 删除 整合 测试 类 上 的 unittest.skip 修饰 器 ， 而 且 在 这 个 类 中 要 使 用 新 视图 new_ 
list2， 看 看 为 清单 属 主编 写 的 新 代码 是 否 真得 可 用 : 











lists/tests/test_views.py (ch191033) 


class NewListViewIntegratedTest(TestCase): 


def test_saving_a_POST_request(self): 
|| 


def test list owner is _ saved if user is authenticated(self): 
request = HttpRequest() 
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日 





request.user = User.objects.create(email='a@b.com') 
request.POST['text'] = 'new list item' 
new_list2(request) 

list_ = List.objects.first() 
self.assertEqual(list_ .owner, request.user) 

















那么 测试 的 结果 如 何 呢 ? 啊 ， 情 况 不 妙 ! 


测试 隔离 有 个 很 重要 的 知识 点 : 虽然 它 有 可 能 帮助 你 为 单独 各 层 做 出 好 的 设计 ， 但 无 法 自 


ERROR: test list owner_ is saved if user_ is authenticated 


| We 
ERROR: test_saving a_POST_request 
[...] 


ERROR: test_redirects_after_POST 

(lists.tests.test views.NewListViewIntegratedTest) 

File "/workspace/superlists/lists/views.py", line 30, in new_list2 
return redirect(list ) 


蕊 地] 


TypeError: argument of type 'NoneType' is not iterable 


FAILED (errors=3) 














动 验证 各 层 之 间 的 集成 情况 。 
上 述 测试 结果 表明 ， 视 图 期 望 表 单 返回 一 个 待 办 事项 : 























lists/views.py 
list_ = form.save(owner=request.user) 
return redirect(list ) 
但 没 让 表单 返回 任何 值 : 
lists/forms.py 


def save(self, owner): 
if owner.is_authenticated(): 
List.create new(first item text=self.cleaned_ data['text'], owner=owner) 
else: 
List.create new(first item text=self.cleaned_data[ 'text']) 


19.8 把 层 与 层 之 间 的 交互 当 作 “合约 ” 














Dee 








除了 隔离 的 单元 测试 之 外 ， 就 算 什 么 都 没 写 ， 功 能 测试 最 终 也 能 发 现 这 个 失误 。 但 理想 情 
况 下 ， 我 们 希望 尽早 得 到 反馈 
要 几 个 小 时 。 在 这 种 问题 发 生 之 前 有 没有 办 法 避免 呢 ? 





功能 测试 可 能 要 运行 好 几 分 钟 ， 应 用 变 大 之 后 甚至 可 能 





E 论 上 讲 ， 有 办 法 : 把 层 与 层 之 间 的 交互 看 成 一 种 “合约 ”。 只 要 模拟 一 层 的 行为 ， 就 要 在 





心里 记 住 ， 层 与 层 之 间 现 在 有 了 隐形 合约 ， 这 一 层 的 双 件 或 许可 以 转移 到 下 一 层 的 测试 中 。 





遗忘 的 合约 如 下 所 示 : 
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利 19 草 


@ 模拟 的 form.save 方法 返回 一 个 对 象 ， 我 们 希望 在 视 


lists/tests/test views.py 


@patch('lists.views.redirect') 

def test redirects_ to_form returned object if_ form valid( 
self, mock_redirect, mockNewListForm 

): 
mock_form = mockNewListForm.return_value 
mock_form.is valid.return_ value = True 


response = new_list2(self.request) 


self.assertEqual(response, mock_redirect.return_value) 
mock_redirect.assert called once with(mock_form.save.return_value) #@ 


中 使 用 这 个 对 象 。 





/说 

















19.8.1 找 出 隐形 合约 
现在 要 审查 NewListViewUnitTest 类 中 的 每 个 测试 ， 看 看 各 驭 件 在 隐形 合约 中 表述 了 什么 : 


0 

















lists/tests/test views.py 


def test passes_POST_data_to_ NewListForm(self, mockNewListForm): 


[ss] 
mockNewListForm.assert_called_ once with(data=self.request.POST) #©@ 


def test_ saves_form with owner_if_form valid(self, mockNewListForm): 
mock_form = mockNewListForm.return_value 
mock_form.is_valid.return_value = True #@ 
new_list2(self.request) 
mock_form.save.assert_called once with(owner=self.request.user) #@ 


def test does_ not save if _ form invalid(self, mockNewListForm): 


[...] 
mock_form.is_ valid.return_value = False #@ 
[| 


@patch('lists.views.redirect') 

def test redirects_ to_ form returned object if form valid( 
self, mock_redirect, mockNewListForm 

be 
[Sa 


mock_redirect.assert _ called once with(mock_form.save.return_value) #@ 


def test_renders_home_ template with form if_form invalid( 


[ee 
需要 传人 POST 请 求 中 的 数据 ， 以 便 初始 化 表单 。 








@ @ 表单 对 象 要 能 响应 is_valid() 方法 ， 而 且 要 根据 输入 值 判断 返回 True 还 是 False。 
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日 “表单 对 象 要 能 响应 .save 方法， 而且 传 和 的 参数 值 是 request.user， 然 后 根据 用 户 是 
否 登录 做 相应 处 理 。 


日 ”表单 对 象 的 .save 方法 应 该 返回 一 个 新 清单 对 象 ， 以 便 视图 把 用 户 重 定向 到 显示 这 个 
对 象 的 页 面 。 











仔细 分 析 表 单 测 试 ， 可 以 看 出 ， 其 实 只 明确 测试 了 第 三 点 。 第 一 点 和 第 二 点 很 幸运 ， 因 为 
这 是 Django 中 ModelForn 的 默认 特性 ， 而 且 针对 父 类 ItemForm 的 测试 涵盖 了 这 两 点 。 


但 第 四 点 却 成 了 漏网 之 鱼 。 





使 用 由 外 而 内 的 TDD 技术 编写 隔离 测试 时 ， 要 记 住 每 个 测试 在 合约 中 对 下 
一 层 应 该 实现 的 功能 做 出 的 隐 含 假设 ,而 且 记 得 稍 后 要 回来 测试 这 些 假设 。 
你 可 以 在 便签 上 记 下 来 ， 也 可 以 使 用 self.fail 编写 占 位 测试 。 














19.8.2 ”修正 由 于 琉 忽 导致 的 问题 
下 面 添 加 一 个 新 测试 ， 确 保 表 单 返 回 刚 刚 保 存 的 清单 : 




















lists/tests/test forms.py (ch191038-1) 


@patch('lists.forms.List.create new') 

def test _ save_returns_new_list object(self, mock List create_ new): 
user = Mock(is_ authenticated=lambda: True) 
form = NewListForm(data={'text': 'new item text'}) 
form.is_valid() 
response = form.save(owner=user) 
self.assertEqual(response, mock_ List create new.return_value) 











其 实 ， 这 是 个 很 好 的 示例 一 一 和 List.create_new 之 间 有 隐形 合约 ， 希 望 这 个 方法 返回 刚 
创建 的 清单 对 象 。 下 面 为 这 个 需求 添加 一 个 占 位 测试 : 








lists/tests/test models.py (ch191038-2) 
class ListModelTest(TestCase): 


[...] 


def test_ create_ returns_ new_list object(self): 
self.fail() 


得 到 一 个 失败 测试 ， 告 诉 我 们 要 修正 表单 对 象 的 save 方法 : 





AssertionError: None != <MagicMock name='create new()' id='139802647565536'> 
FAILED (failures=2, errors=3) 


修正 方法 如 下 : 





lists/forms.py (ch191039-1) 


class NewListForm(ItemForm): 


def save(self, owner): 
if owner.is_authenticated(): 
return List.create new(first item text=self.cleaned datal[ 'text'], 
owner=owner) 
else: 
return List.create new(first item text=self.cleaned data[ 'text']) 


这 才刚 开始 。 下 面 应 该 看 一 下 占 位 测试 : 





[...] 


FAIL: test_create _returns_new_list object 
self.fail() 
AssertionError: None 


FAILED (failures=1, errors=3) 


编写 这 个 测试 


lists/tests/test_ models.py (ch191039-2) 


def test create returns new_list object(self): 
returned = List.create new(first item text='new item text') 
new_List = List.objects.first() 
self.assertEqual(returned, new_list) 


测试 结果 为 : 


然后 加 上 返回 值 ; 


AssertionError: None != <List: List object> 














lists/models.py (ch191039-3) 


@staticmethod 

def create new(first item text, owner=None): 
list_ = List.objects.create(owner=owner) 
Item.objects.create(text=first item text, list=list ) 
return list_ 


现在 整个 测试 组 件 都 可 以 通过 了 : 


$ python3 manage.py test lists 


Eis 
Ran 50 tests in 0.169s 


OK 





昌 
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19.9 还 缺 一 个 测试 
以 上 就 是 由 测试 驱动 开发 出 来 的 保存 清单 属 主 功能 ， 这 个 功能 可 以 正常 使 用 。 不 过 ， 功 能 
测试 却 无 法 通过 














$ python3 manage.py test functionaL_tests.test_my_Lists 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"link text","selector":"Reticulate splines"}' ; Stacktrace: 














失败 的 原因 是 有 一 个 功能 没 实现 ， 即 清单 对 象 的 .name 属性 。 这 里 还 可 以 使 用 前 一 章 的 测 
试 和 代码 : 








lists/tests/test models.py (ch191040) 


def test list name is first item text(self): 
list = List.objects.create() 
Item.objects.create(list=list , text='first item') 
Item.objects.create(list=list_ , text='second item') 
self.assertEqual(list_ .name, 'first item') 











ee 所 以 使 用 ORM 没 问题 。 你 可 能 想 使 用 到 件 编写 这 个 测 
试 ， 不 过 这 么 做 没什么 意义 。) 














lists/models.py (ch191041) 


@property 
def name(self): 
return self.item set.first().text 





现在 功能 测试 可 以 通 
$ python3 manage.py test functional._tests.test my_lists 
Ran 1 test in 21.428s 


OK 


19.10 清理 : 保留 哪些 整合 测试 
现在 一 切 都 可 以 正常 运行 了 ， 要 删除 一 些 多 余 的 测试 ， 还 要 决定 是 否 保留 以 前 的 整合 测试 。 


19.10.1 删除 表单 层 多 余 的 代码 


可 以 把 以 前 针对 ItemForm 类 中 save 方法 的 测试 删 掉 : 





lists/tests/test forms.py 


- a/lists/tests/test_ forms.py 
+++ b/lists/tests/test forms.py 





QQ -23,14 +23,6 QQ class ItemFormTest(TestCase) : 


self.assertEqual(form.errors['text'], [EMPTY_LIST_ERROR]) 


- def test_ form_ save_handles_saving to a list(self): 

- List_ = List.objects.create() 

- form = ItemForm(data={'text': 'do me'}) 

- new_item = form.save(for_list=list ) 

- self.assertEqual(new_item, Item.objects.first()) 
- self.assertEqual(new_item.text, 'do me') 

- self.assertEqual(new_item.list, list ) 


对 应 用 的 代码 而 言 ， 可 以 把 forms.py 中 两 个 多 余 的 save 方法 删 掉 : 


lists/forms.py 
--- a/lists/forms.py 


+++ b/lists/forms.py 

QQ -22,11 +22,6 QQ class ItemForm(forms.models.ModelForm): 
self.fields['text'].error_messages['required'] = EMPTY_LIST_ERROR 

- def save(self, for_list): 


- self.instance.list = for_list 
- return super().save() 


class NewListForm(ItemForm): 
QQ -52,8 +47,3 QQ class ExistingListItemForm(ItemForm): 
e.error_dict = {'text': [DUPLICATE_ITEM_ ERROR]} 


self._update_errors(e) 


- def save(self): 
- return forms.models.ModelForm.save(self) 


19.10.2 删除 以 前 实现 的 视图 
E， 可 以 把 以 前 的 new_List 视图 完全 删 掉 ， 再 把 new_list2 重 命名 为 new_List: 














迪 
讨 














lists/tests/test views.py 


-from lists.views import new_list, new_list2 
+from lists.views import new_list 


class HomePageTest(TestCase) : 
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@@ -75,7 +75,7 @@ class NewListViewIntegratedTest(TestCase): 
request = HttpRequest() 
request.user = User.objects.create(email='a@b.com') 
request.POST['text'] = 'new list item' 

- new_list2(request) 

+ new_list(request) 
list_ = List.objects.first() 
self.assertEqual(list .owner, request.user) 


QQ -91,21 +91,21 @@ class NewListViewUnitTest(unittest.TestCase):#Q 


def test_ passes_POST_data_to_ NewListForm(self, mockNewListForm): 
- new_list2(self.request) 
+ new_list(self.request) 


[.. several more] 


lists/urls.py 


--- a/lists/urls.py 
+++ b/lists/urls.py 
@@ -2,6 +2,6 @@ from django.conf.urls import patterns, url 


urlpatterns = patterns(' '， 
url(r'^(\d+)/$', 'lists.views.view list', name='view_ list'), 

- url(r'^new$', 'lists.views.new_list2', name='new_list'), 

+ url(r'^new$', 'lists.views.new_ list', name='new_list'), 
url(r'^users/(.+)/$', 'lists.views.my_lists', name='my_lists'), 


lists/views.py (ch191047) 
def new_list(request): 
form = NewListForm(data=request.POST) 
if form.is_valid(): 
list_ = form.save(owner=request.user) 
|| 
然后 检查 所 有 测试 是 否 仍 能 通过 : 


OK 
19.10.3 ”删除 视图 层 多 余 的 代码 
最 后 要 决定 保留 哪些 整合 测试 (如果 需要 保留 的 话 )。 
一 种 方法 是 全 部 删除 ， 让 功能 测试 捕获 集成 问题 。 这 么 做 完全 可 行 。 

















不 过 ， 从 前 文 得 知 ， 如 果 在 集成 各 层 时 犯 了 小 错误 ， 整 合 测 试 可 以 提醒 你 。 可 以 保留 部 分 
测试 ， 作 为 完整 性 检查 ， 以 便 得 到 快速 反馈 。 


要 不 就 保留 下 面 这 三 个 测试 吧 : 





lists/tests/test_ views.py (ch191048) 


class NewListViewIntegratedTest(TestCase): 


def test saving a_POST_request(self): 
self.client.post( 
'/lists/new', 
data={'text': 'A new list item'} 
) 
self.assertEqual(Item.objects.count(), 1) 
New_item = Item.objects.first() 
self.assertEqual(new_item.text, 'A new list item') 


def test for_invalid input doesnt_save_but_ shows_errors(self): 
response = self.client.post('/lists/new', data={'text': ''}) 
self.assertEqual(List.objects.count(), 0) 
self.assertContains(response, escape(EMPTY_LIST_ERROR)) 


def test saves_list owner_if user_logged in(self): 
request = HttpRequest() 
request.user = User.objects.create(email='a@b.com') 
request.POST['text'] = 'new list item' 
new_list(request) 
list = List.objects.first() 
self.assertEqual(list .owner, request.user) 


如 有 果 最 终 决 定 保留 中 间 层 的 测试 ， 我 认为 这 三 个 不 错 ， 因 为 我 觉得 它们 涵盖 了 大 部 分 集成 
操作 ， 它 们 测试 了 整个 组 件 ， 从 请 求 直 到 数据 库 ， 而 且 和 覆盖 了 视图 最 重要 的 三 个 用 例 。 


19.11 总 结 : 什么 时 候 编 写 隔 离 测试 ， 什 么 时 候 
编写 整合 测试 

Django 提供 的 测试 工具 为 快速 编写 整合 测试 提供 了 便利 。 测 试 运行 程序 能 帮助 我 们 创建 
一 个 存在 于 内 存 中 的 数据 库 ， 运 行 速度 很 快 ， 而 且 在 两 次 测试 之 间 还 能 重建 数据 库 。 使 
用 TestCase 类 和 测试 客户 端 测 试 视 图 很 简单 ， 可 以 检查 是 否 修改 了 数据 库 中 的 对 象 ， 确 认 
URL 映射 是 否 可 用 ， 还 能 检查 演 染 模板 的 情况 。 这 些 工具 降低 了 测试 的 门槛 ， 而 且 对 整个 
组 件 而 言 也 能 获得 不 错 的 覆盖 度 。 
但 是 ， 从 设计 的 角度 来 说 ， 这 种 整合 测试 比 不 上 严格 的 单元 测试 和 由 外 而 内 的 TDD， 因 为 
它 没有 后 者 的 优势 全 面 。 


就 本 章 的 示例 而 言 ， 可 以 比较 一 下 修改 前 后 的 代码 : 



























































Before. 


def new_list(request): 
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form = ItemForm(data=request.POST) 
if form.is_valid(): 
list = List() 
if not isinstance(request.user, AnonymousUser): 
list_.owner = request.user 
list_.save() 
form.save(for_list=list ) 
return redirect(list ) 
else: 
return render(request, 'home.html', {"form": form}) 


After. 


def new_list(request): 
form = NewListForm(data=request.POST) 
if form.is_valid(): 
list_ = form.save(owner=request.user) 
return redirect(list ) 
return render(request, 'home.html', {'form': form}) 








如 果 想 省 点 儿 事 ， 不 走 隔离 测试 这 条 路 ,会 下 功夫 重 构 视图 函数 吗 ? 我 知道 写作 本 书 草 稿 
时 我 不 会 。 我 希望 自己 在 真实 的 项 目 中 会 这 么 做 ， 但 也 不 能 保证 。 可 是 编写 隔离 测试 却 让 
你 看 清 代码 复杂 在 何 处 。 


19.11.1 以 复杂 度 为 准则 
不 得 不 说 ， 处 理 复杂 问题 时 才能 体现 隔离 测试 的 优势 。 本 书 中 的 例子 非常 简单 
得 这 么 做 。 就 算是 本 章 的 例子 ， 我 也 能 说 服 自己 ， 完 全 不 用 编写 这 些 隔离 测试 。 


可 一 旦 应 用 变 得 复杂 ， 比 如 视图 和 模型 之 间 分 了 更 多 层 ， 或 者 需要 编写 辅助 方法 或 自己 的 
类 ， 那 时 多 编写 一 些 隔离 测试 或 许 就 能 从 中 受益 了 。 




















还 不 太 值 

















19.11.2 ”两 种 测试 都 要 与 吗 
功能 测试 组 件 能 告诉 我 们 集成 各 部 分 代码 时 是 否 有 问题 。 隔 离 测试 能 帮助 我 们 设计 出 更 好 
的 代码 ， 还 能 验证 细 闻 的 处 理 是 否 正确 。 那 么 中 间 层 集成 测试 还 有 其 他 作用 吗 ? 


我 想 ， 如 果 集 成 测试 能 更 快 地 提供 反馈 ， 或 者 能 更 精确 地 找 出 集成 问题 的 原因 所 在 ， 那 
么 答案 就 是 肯定 的 。 集 成 测试 的 优势 之 一 是 ， 它 在 调用 跟踪 中 提供 的 调试 信息 比 功能 测 
试 详细 。 
甚至 还 可 以 把 各 组 件 分 开 可 以 编写 一 个 速度 快 、 隔 离 的 单元 测试 组 件 ， 完 全 不 用 
manage.py， 因 为 这 些 测 试 不 需要 Django 测试 运行 程序 提供 的 任何 数据 库 清 理 操 作 。 然 后 
使 用 Django 提供 的 工具 编写 中 间 层 测试 ， 最 后 使 用 功能 测试 检查 与 过 渡 服 务 器 交互 的 各 
层 。 如 果 各 层 提 供 的 功能 循序 渐进 ， 或 许 就 可 以 采用 这 种 方案 。 






























































到 底 怎 么 做 ， 要 根据 实际 情况 而 定 。 我 希望 读 过 这 一 章 之 后 ， 你 能 体会 到 如 何 权衡 。 
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19.11.3 ”继续 前 行 
对 新 版 代码 很 满意 ， 那 就 合并 到 主 分 支 吧 





$ git add . 

$ git commit -m"add list owners via forms. more isolated tests" 
$ git checkout master 

$ git checkout -b master-noforms-noisolation-bak # 也 可 以 做 个 备份 
$ git checkout master 

$ git reset --hard more-isolation # 把 主 分 支 重 设 到 这 个 分 支 


现在 ， 运 行 功 能 测试 要 花 很 长 时 间 ， 我 想 知道 我 们 能 不 能 做 些 什 么 来 改善 这 种 状况 。 








不 同 测 试 类 型 以 及 解 而 ORM 代码 的 利 浆 
功能 测试 
。 从 用 户 的 角度 出 发 ， 最 大 程度 上 保证 应 用 可 以 正常 运行 ; 
。 但 是 ， 反 馈 循 环 用 时 长 ; 
。 无 法 帮助 我 们 写 出 简洁 的 代码 。 
整合 测试 (依赖 于 ORM 或 Django 测试 客户 匣 等 ) 
。 编写 速度 快 ; 
。 易于 理解 ; 
。 发 现任 何 集成 问题 都 会 提醒 你 ; 
。 但 是 ， 并 不 总 能 得 到 好 的 设计 (这 取决 于 你 自己 | ) ; 
。 一 般 运 行 速度 比 隔离 测试 慢 。 
陪 离 测试 (使 用 驭 件 ) 
。 涉及 的 工作 量 最 大 ; 
。 可 能 难以 阅读 和 理解 ; 
。 但 是 ， 这 种 测试 最 能 引导 你 实现 更 好 的 设计 ; 
。 运行 速度 最 快 。 
解 契 应 用 代码 和 ORM 代码 
钟情 于 隔离 测试 导致 我 们 不 得 不 从 视图 和 表单 等 处 删除 ORM 代码 ， 把 它们 放 到 辅 
助 也 数 或 者 辅助 方法 中 。 如 果 从 解 耦 应 用 代码 和 ORM 代码 的 角度 看 ， 这 么 做 有 好 
处 ， 还 能 提高 代码 的 可 读 性 。 当 然 ， 所 有 事情 都 一 样 ， 要 结合 实际 情况 判断 是 否 值 
得 付出 额外 精力 去 做 。 
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持续 集成 





网 站 越 变 越 大 ， 运 行 所 有 功能 测试 的 时 间 也 越 来 越 长 。 如 果 时 长 一 直 增加 ， 我 们 很 可 能 不 
再 运行 功能 测试 。 





为 了 避免 发 生 这 种 情况 ， 可 以 搭建 一 个 “持续 集成 ”(Continuous Integration， 简 称 CI) 服 
务 器 ， 自 动 运行 功能 测试 。 这 样 ， 在 日 常 开发 中 ， 只 需 运行 当下 关注 的 功能 测试 ， 整 个 测 
试 组 件 则 交 给 CI 服务 器 自动 运行 。 如 果 不 小 心 破坏 了 某 项 功能 ，CI 服务 器 会 通知 我 们 。 
单元 测试 的 运行 速度 一 直 很 快 ， 每 隔 几 秒 就 可 以 运行 一 次 。 








现在 ， 开 发 者 喜欢 使 用 的 CI 服务 器 是 Jenkins。Jenkins 使 用 Java 开发 ， 经 常 出 问题 ， 界 面 
也 不 漂亮 ， 但 大 家 都 在 用 ， 而 且 揪 件 系 统 很 棒 ， 下 面 安装 并 运行 Jenkins。 








20.1 安装 Jenkins 


CI 托管 服务 有 很 多 ， 基 本 上 都 提供 了 一 个 立即 就 能 使 用 的 Jenkins 服务 器 。 我 知道 的 就 有 
Sauce Labs、Travis、Circle-CI 和 ShiningPanda， 可 能 还 有 更 多 。 假 设 要 在 自己 有 控制 权 的 
服务 器 上 安装 所 需 的 一 切 软件 。 


把 Jenkins 安装 在 过 渡 服 务 器 或 生产 服务 器 上 可 不 是 个 好 主意 ， 因 为 有 很 多 
操作 要 交 给 Jenkins 完成 ， 比 如 重新 引导 过 渡 服 务 器 。 








要 从 Jenkins 的 官方 apt 仓库 中 安装 最 新 版 ， 因 为 Ubuntu 默认 安装 的 版 本 对 本 地 化 和 
Unicode 支持 还 有 些 恼 人 的 问题 ， 而 且 默 认 配 置 也 没 监听 外 网 : 
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# 从 Jenkins 网 站 上 查 到 的 安装 说 明 

user@server:$ wget -q -0 - http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key |\ 
sudo apt-key add - 

user@server:$ echo deb http://pkg.jenkins-ci.org/debian binary/ | sudo tee \ 
/etc/apt/sources.list.d/jenkins.list 

user@server:$ sudo apt-get update 

user@server:$ sudo apt-get install jenkins 


此 外 还 要 安装 几 个 依赖 : 


user@server:$ sudo apt-get install git firefox python3 python-virtualenv xvfb 


写作 本 书 时 ，shiningpanda 插件 不 兼容 Python 3.4 (https://issues.jenkins-ci.org/ 
browse/JENKINS-22902) ， 但 在 Python 3.3 中 可 以 正常 使 用 ， 所 以 我 建议 操 
作 系 统 使 用 稍微 旧 一 点 儿 的 发 行 版 本 ， 因 为 默认 安装 的 Python 3 版 本 稍微 低 
点 儿 。 例 如 ， 可 以 使 用 Ubuntu Saucy (13.10) ， 但 不 能 用 Trusty (14.04)。 














然后 就 可 以 访问 服务 器 的 URL， 通 过 8989 端口 访问 Jenkins， 如 图 20-1 所 示 。 





Dashboard Jenkins] - Mozilla Firefox [3 
File Edit View History Bookmarks Tools Help 
| 鳃 pashboard [Jenkins] [| 字 | 

€ |@ jenkins.ottg.eu:8080 v 包 | 图 Goodle Qu 合 Kr 





Jenkins ENABLE AUTO REFRESH 
国 add description 
入 New Job Welcome to Jenkins! Please create new jobs to get started. 
多 People 
E Build History 


Manage Jenkins 
区 Manage Jenkins 


Build Queue 
No builds in the queue. 


Build Executor Status 





天 Status 
1 idle 
2 ldle 
Page generated: 03-Nov-2013 10:36:31 RESTAPI Jenkinsver 1.509.2 
加 X S) 曲 











图 20-1: 看 到 一 个 男 仆 ,好 奇怪 
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20.1.1 Jenkins 的 安全 配置 
首先 我 们 要 设置 一 些 认证 措施 ， 因 为 我 们 的 服务 器 通过 外 网 可 以 访问 ; 


。 Manage Jenkins (管理 Jenkins) 一 Configure Global Security (全 局 安全 配置 ) 一 Enable 
security (启用 安全 措施 ) ， 

。 选择 “Jenkins” own user database” (Jenkins 自己 的 用 户 数 据 库 )， 以 及 “Matrix-based 
security”( 基 于 矩阵 的 安全 措施 ) ; 

。 取消 匿名 用 户 的 所 有 权限 ， 

。 然后 为 自己 添加 一 个 用 户 ， 并 且 赋 予 所 有 权限 (如 图 20-2) ， 

。 下 一 个 页 面 会 显示 一 些 输入 框 ， 为 刚才 添加 的 用 户 创建 账户 ， 还 要 设 定 密码 。' 











Configure Global Security Jenkins] - Mozilla Firefox ® 
File Edit View History Bookmarks Tools Help 
| 鳃 configure Global security [Jen... Bal 


《 je ottg.eu gure -@ | 国 - Goodle QL 合 Hr 
Jenkins Configure Global Security 


Authorization 





Anyone can do anything 

Legacy mode 

Logged-in users can do anything 
@ Matrix-based security 


Overall Slave 


Eee AdministenReadRunscriptsUploadPluginsConfigureUpdateCenterConfigureDeleteiCreateDisconnecbConnectCreate0 

Anonymous 钾 国 一 一 一 一 一 一 二 = 

OG | B | 加 Ho Bo 
User/group to add: |harry | _Add | | 


Project-based Matrix Authorization Strategy 


Prevent Cross Site Request Forgery exploits 


Lse Lay | 


加 其 9) 曲 











图 20-2: 限制 访问 
20.1.2 ”添加 需要 的 插件 
接 下 来 安装 一 些 插件 ， 提 供 Git、Python 和 虚拟 显示 器 支持 ， 如 图 20-3: 


。 Manage Jenkins (管理 Jenkins) 一 Manage Plugins (管理 插件 ) 一 Available (可 用 插件 ) 









































注 1: 如 果 没 看 到 这 个 页 面 ， 可 以 点 击 “signup”( 注 册 ) 链接 ， 只 要 使 用 刚才 指定 的 用 户 名 就 能 创建 账户 。 
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要 安装 的 插件 是 : 











。 Git; 
。 ShiningPanda; 
。 Xvfb。 
Update Center [Jenkins] - Mozilla Firefox x 
File Edit View History Bookmarks Tools Help 
| 便 Update Center [Jenkins] | 咖 | 
€ |@ jenkins.ottg.eu:8080/updateCenter, "©| 图 Goodle Qu 合 和 ” 
9 一 
Jenkins EE CA 
Jenkins Update center ENABLE AUTO REFRESH 
Back to Dashboard ， 
epashbeas Installing Plugins/Upgrades 
Manage Jenkins 
过 Preparation 
.号 Manaae Plugins se Checking internet connectivity 
ae e Checking update center connectivity 
® Success 
Credentials Plugin Downloaded Successfully. Will be activated during the next boot 
SSH Credentials Plugin Downloaded SuccessFully. Will be activated during the next boot 
Git Client Plugin Installing 
Ss | 
SCM API Plugin [ Pending 
Git Plugin oy] Pending 
Xvfb Plugin 《 3 Pending 
ShiningPanda Plugin 局 "endno 








中 Co back to the top page 
(you can start using the installed plugins right away) 


国门 pectart lenkine when inctallation ic comnlete and nn inhe are ninninn 


加 % 5 


| 念 6 














图 20-3: 安装 插件 











安装 完成 后 重启 Jenkins 一 一 可 以 在 下 个 页 面 中 勾 选 相应 选项 ， 也 可 以 在 命令 行 中 执行 sudo 


service jenkins restart 命令 。 











告诉 Jenkins 到 哪里 寻找 Python 3 和 Xvfb 

要 告诉 ShiningPanda 插件 Python 3 安装 在 哪里 (一 般 安装 在 /usr/bin/python3， 不 过 也 可 执 
行 which python3 命令 查看 ) : Manage Jenkins (管理 Jenkins) 一 Configure System (系统 
配置 ) 0° 





。 Python 一 Python installations (Python 安装 位 置 ) 一 Add Python (添加 Python) (如 图 20-4) ， 
。 Xvfb installation (Xvfb 安装 位 置 ) 一 Add Xvfb installation (添加 Xvfb 安装 位 置 ) ， 在 安 
装 目录 中 输入 /usr/bin。 














Python 


Python installations Python 
Name System-CPython-2.7 回 
Home or executable [usr/bin/python2.7 加 
DD Install automatically @ 
Delete Python | 
Python 
Name Python-3 加 
Home or executable fusr/bin/python3 加 
_] Install automatically @ 
Delete Python | 
Add Python 








20-4: Python 安装 在 哪里 


20.2 设置 项 目 


现在 Jenkins 基本 配置 好 了 ， 下 面 设置 项 目 : 





。 New Job (新 建 作 业 ) 一 Build a free-style software project (构建 一 个 自由 软件 项 目 ) ; 
。 添加 Git 仓库 ， 如 图 20-5; 








Source Code Management 
®t 
Tepesmones Repository URL [https://github.com/hjwp/book-example.git 加 © 


Credentials - none - 


| Advanced... | 





Add Repository | Delete Repository | 














20-5: 从 Git 仓库 中 获取 源码 





。 设 为 每 小 时 轮 询 一 次 〈 如 图 20-6) (看 一 下 帮助 文本 ,触发 构建 操作 还 有 很 多 其 他 方式 ) 
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图 pollscM 


Schedule H<*** 


图 因 


This field Follows the syntax of cron (with minor differences). Specifically each line consists of 5 Fields separated 
by TAB or whitespace: 
MINUTE HOUR DOM MONTH DOW 


MINUTE Minutes within the hour (0-59) 
HOUR The hour of the day (0-23) 
DOM The day of the month (1-31) 
MANTH The manth (1-17)\ 








20-6: 轮 询 Github， 获 取 改 动 


。 在 一 个 Python 3 虚拟 环境 中 运行 测试 ， 
。 单元 测试 和 功能 测试 分 开 运 行 ， 如 图 20-7。 











Build 
Virtualenv Builder 加 
Python version | Python-3 和 加 
Clear @ 
Nature Shell i ©@ 
Command pip install -r requirements.txt 加 


| Advanced | 








20-7: 虚拟 环境 中 执行 的 构建 步骤 


20.3 第 一 次 构建 








点 击 “Build Now!”( 现 在 构建 ) 按钮 ， 然 后 查看 “Console Output”( 终 端 输 出 )， 应 该 会 
看 到 类 似 下 面 的 内 容 : 

Started by user harry 

Building in workspace /var/lib/jenkins/jobs/Superlists/workspace 

Fetching changes from the remote Git repository 

Fetching upstream changes from https://github.com/hjwp/book-example.git 

Checking out Revision d515acebf7e173f165ce713b30295a4a6ee17c07 (origin/master) 

[workspace] $ /bin/sh -xe /tmp/shiningpanda7260707941304155464.sh 

+ pip install -r requirements.txt 

Requirement already satisfied (use --upgrade to upgrade): Django==1.7 in 
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/var/Lib/jenkins/shiningpanda/jobs/ddclaed1/virtuaLenvs/d41d8cd9/Lib/python3.3/site-packages 
(from -r requirements.txt (Line 1)) 
Downloading/unpacking South==0.8.2 (from -r requirements.txt (Line 2)) 

Running setup.py egg_info for package South 


Requirement already satisfied (use --upgrade to upgrade): gunicorn==17.5 in 

/var/lib/jenkins/shiningpanda/jobs/ddciaed1/virtualenvs/d41d8cd9/lib/python3.3/ 

site-packages 

(from -r requirements.txt (line 3)) 

Downloading/unpacking requests==2.0.0 (from -r requirements.txt (line 4)) 
Running setup.py egg_info for package requests 


Installing collected packages: South, requests 
Running setup.py install for South 


Running setup.py install for requests 


Successfully installed South requests 
Cleaning up... 
+ python manage.py test lists accounts 


Ran 51 tests in 0.323s 


OK 

Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 

+ python manage.py test functional_tests 

ImportError: No module named 'selenium’ 

Build step 'Virtualenv Builder' marked build as failure 


啊 ， 在 虚拟 环境 中 要 安装 Selenium。 
在 构建 步骤 中 添加 一 步 ， 手 动 安装 Selenium: 





pip install -r requirements.txt 

pip install seLentum==2.39 

python manage.py test accounts lists 
python manage.py test functional_tests 


有 些 人 喜欢 使 用 test-requirements.txt 文件 指定 测试 (不 是 主 应 用 ) 需要 的 包 。 








现在 情况 如 何 ? 


File 
"/var/lib/jenkins/shiningpanda/jobs/ddc1laed1/virtualenvs/d41d8cd9/1lib/python3. 
line 100, in _wait_until_connectable 









































注 2: 写作 本 书 时 , 我 使 用 最 新 版 Selenium (2.41) 过 到 一 些 问题 (https://code.google.com/p/selenium/issues/ 
detail?id=7073) ， 所 以 这 里 才 明 确 指定 使 用 2.39 版 。 请 你 务必 试 一 下 较 新 的 版 本 ! 
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self. get firefox_output()) 
selenium.common.exceptions.WebDriverException: Message: 'The browser appears to 
have exited before we could connect. The output was: b"\\n(process:19757): 
GLib-CRITICAL **: g_slice_ set _config: assertion \'sys_page_size == 8N' 
failed\\nError: no display specified\\n"’ 


20.4 ”设置 虚拟 显示 器 ， 让 功能 测试 能 在 无 界面 的 
环境 中 运行 
从 调用 跟踪 中 可 以 看 出 ，Firefox 无 法 启动 ， 因 为 服务 器 没有 显示 器 。 


这 个 问题 有 两 种 解决 方法 。 第 一 种 ， 换 用 无 界面 浏览 器 (headless browser) ， 例 如 PhantomJS 
或 SlimerJS。 这 种 工具 绝对 有 存在 的 意义 ， 最 大 的 特点 是 运行 速度 快 ， 但 也 有 缺点。 首先 ， 
它们 不 是 “真正 的 ”Web 浏览 器 ， 所 以 无 法 保证 能 捕获 用 户 使 用 真正 的 浏览 器 时 遇 到 的 全 部 
怪异 行为 。 其 次 ， 它 们 在 Selenium 中 的 表现 差异 很 大 ， 因 此 要 花费 大 量 精 力 重 写 功能 测试 。 














我 只 把 无 界面 浏览 器 当做 开发 工具 ， 目 的 是 在 开发 者 的 设备 中 提升 功能 测试 
的 运行 速度 。 在 CI 服务 器 上 运行 测试 则 使 用 真正 的 浏览 器 。 














第 二 种 解决 方法 是 设置 虚拟 显示 器 : 让 服务 器 认为 自己 连接 了 显示 器 ， 这 样 Firefox 就 能 
正常 运行 了 。 这 种 工具 很 多 , 我 们 要 使 用 的 是 “Xvfb”(X Virtual Framebuffer)“, 因为 它 安 
装 和 使 用 都 很 简单 ， 而 且 还 有 一 个 合用 的 Jenkins 插件 。 

回 到 项 目 页 面 ， 点 击 “Configure” (配置 )， 找 到 “Build Environment”( 构 建 环境 ) 部 分 。 
启用 虚拟 显示 器 的 方法 很 简单 ， 勾 选 “Start Xvfb before the build, and shut it down after” 
(构建 前 启动 Xvfb， 并 在 构建 完成 后 关闭 ) 即 可 ， 如 图 20-8 所 示 。 








lgnore post-commit hooks 


Build Environment 





加 startXvfb before the build, and shutit down after 


Build 


Virtualenv Ruilder 


20-8: 有 时 配置 方式 很 简单 























注 3: 如 果 想 在 Python 代码 中 控制 虚拟 显示 器 , 可 以 试 试 pyvirtualdisplay 《https://pypipython.org/pypi/PyVirtualDisplay)。 
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现在 构建 过 程 顺利 多 了 : 


[...] 


Xvfb starting$ /usr/bin/Xvfb :2 -screen 0 1024x768x24 -fbdir 


/var/lib/jenkins/2013-11-04_03-27-221510012427739470928xvfb 


Ee 


+ python manage.py test lists accounts 


Ran 51 tests in 0.410s 


OK 


Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 


+ pip install selenium 


Requirement already satisfied (use --upgrade to upgrade): selenium in 
/var/lib/jenkins/shiningpanda/jobs/ddc1iaed1/virtualenvs/d41d8cd9/lib/python3.3/ 


site-packages 
Cleaning up... 


+ python manage.py test functional_tests 


FAIL: test_logged in users_lists are_ saved as my_lists 
(functional_tests.test my_lists.MyListsTest) 


Traceback (most recent call last): 


File 


"/var/lib/jenkins/jobs/Superlists/workspace/functional_tests/test_my_lists.py", 

line 44, iin test logged in users_lists are saved as my_lists 
self.assertEqual(self.browser.current url, first list_url) 

AssertionError: 'http://Llocalhost:8081/accounts/edith@example.com/' != 

'http://Llocalhost:8081/Llists/1/" 

- http://LocaLhost:8081/accounts/edithQexampLe.com/ 

+ http://LocaLhost:8081/Lists/1/ 


Ran 7 tests in 89.275s 


FAILED (errors=1) 


Creating test database for alias 'default'... 
[{'secure': False, 'domain': 'localhost', 'name': 'sessionid', 'expiry': 


1920011311, 'path': '/'， 


'value': 'a8d8bbde33nreq6gihw8a7ricc8bf02k'}] 


Destroying test database for alias 'default'... 
Build step 'Virtualenv Builder' marked build as failure 


Xvfb stopping 
Finished: FAILURE 


就 快 成 功 了 ! 为 了 调试 错误 ， 还 需要 截图 。 


稍 后 我 们 会 发 现 ， 





这 个 错误 是 由 条 件 竞争 导致 的 ， 所 以 不 一 定 总 会 出 
可 能 会 看 到 不 同 的 错误 ， 或 者 根本 没 错误 。 不 管 怎 样 ， 下 面 介绍 的 截 


和 处 理 条 件 竞争 的 工具 总 有 一 天 会 用 到 。 继 续 读 吧 ! 








现 。 
图 了 





你 


[有 具 





ps 





20.5 ”截图 


为 了 调试 远程 设备 中 意料 之 外 的 失败 ， 最 好 能 看 到 失败 时 的 屏幕 图 片 ， 或 者 还 可 以 转 储 页 
面 的 HTML。 这 些 操作 可 在 功能 测试 类 中 的 tearDown 方法 里 自 定义 逻辑 实现 。 为 此 ， 要 深 
入 unittest 的 内 部 ， 使 用 私有 属性 _outcomeForDoCleanups， 不 过 像 下 面 这 样 写 也 行 : 






































functional tests/base.py (ch201006) 


import os 

from datetime import datetime 

SCREEN_DUMP_LOCATION = os.path.abspath( 
os.path.join(os.path.dirname(__file ), 'screendumps') 

) 

Fxg 


def tearDown(self): 
if self. test_has_failed(): 
if not os.path.exists(SCREEN_DUMP_LOCATION): 
os .makedirs(SCREEN_DUMP_LOCATION) 
for ix, handle in enumerate(self.browser .window_handles): 
self. windowid = ix 
seLf .browser .switch to window(handle) 
self.take_screenshot() 
self.dump_html() 
self.browser .quit() 
super().tearDown() 


def test has_failed(self): 
# 针对 3.4。 在 3.3 中 可 以 直接 使 用 self._outcomeForDoCleanups.success: 
for method, error in self. outcome.errors: 
if error: 
return True 
return False 
































首先 ， 必 要 时 创建 存放 截图 的 目录 。 人 然后， 遍历 所 有 打开 的 浏览 器 选项 卡 和 页 面 ， 调 用 一 些 
Selenium 提供 的 方法 (get_screen shot_as_file 和 browser.page_source) 截图 以 及 转 储 HTML: 


functional tests/base.py (ch201007) 


def take_screenshot(self): 
filename = self. get filename() + '.png' 
print('screenshotting to', filename) 
self.browser.get_screenshot _as_file(filename) 


def dump_html(self): 
filename = self. get filename() + '.html' 
print('dumping page HTML to', filename) 
with open(filename, 'w') as f: 
f.write(self.browser .page_source) 
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最 后 ， 使 用 一 种 方式 生成 唯一 的 文件 名 标识 符 。 文 件 名 中 包括 测试 方法 和 测试 类 的 名 字 ， 
以 及 一 个 时 间 改 : 
functional tests/base.py (ch201008) 


def get filename(self): 

timestamp = datetime.now().isoformat().replace(':', '.')[:19] 

return '{folder}/{classname}.{method}-window{windowid}-{timestamp}'.format( 
folder=SCREEN_DUMP_LOCATION, 
classname=self. class_ _._ name ， 
method=self._testMethodName, 
windowid=self._windowid, 
timestamp=timestamp 


) 
可 以 先 在 本 地 测试 一 下 ， 故 意 让 某 个 测试 失败 ， 例 如 使 用 self.fail()， 会 看 到 类 似 下 轿 
的 输出 : 

















[ed 


screenshotting to /workspace/superlists/functional_tests/screendumps/MyListsTes 
t.test_logged in users_lists are_ saved as my_lists-window0-2014-03-09T11.19.12. 


png 
dumping page HTML to /workspace/superlists/functional_tests/screendumps/MyLists 


Test.test logged_ in users_lists are_ saved as my_lists-window0-2014-03-09T11.19. 
12.html 


删 掉 self.fail()， 然 后 提交 ， 再 推送 : 


$ git diff # 显示 base.py 中 的 改动 
$ echo "functional_tests/screendumps" >> .gitignore 
$ git commit -am "add screenshot on failure to FT runner" 


$ git push 


在 Jenkins 中 重新 构建 时 ， 会 看 到 类 似 下 面 的 输出 : 


screenshotting to /var/lib/jenkins/jobs/Superlists/workspace/functional_tests/ 
screendumps/LoginTest.test_ login with persona-window0-2014-01-22T17.45.12.png 
dumping page HTML to /var/lib/jenkins/jobs/Superlists/workspace/functional_ tests/ 
screendumps/LoginTest. test_login with persona-window0-2014-01-22T17.45.12.html 








LL 











可 以 在 “工作 空间 ”中 查看 这 些 文件 。 工 作 空 间 是 Jenkins 用 来 存储 源码 以 及 运行 测试 所 
在 的 文件 夹 ， 如 图 20-9 所 示 。 

















Superlists chapter 17 workspace : / [Jenkins] - Mozilla Firefox 
File Edit View History Bookmarks Tools Help 
| 便 superlists chapter 17 workspa... | 中 | 


《 > @ jenkins.ottg.eu:8080/job/Superlis ST 17/Ws v@ | 国 » Goodle Qa 合 Hr 


Jenkin EP 














Jenkins Superiists chapter 17 ENABLE AUTO REFRESH 
会 Backto Dashboard 芒 中 
QO stat 
| Status 
学 changes 国 accounts 
国 depoy toos 
全 "useaee 国 anctonal tests 
[2 Wipe Out Current Workspace 入 ss 
国 superists 
A se 国 ,gitonore 
Delete Project 广 ， 
© 丑 dstribute-0.6.34targz 由 
2 ontoure 
国 manaoepy 


Git Poling Log 





目 reouirements txt 























把 Buid History {trend) 
目 HMyListsTest.test logged in users lsts are saved as my lists- 
#11 ‘Nov 6. 2013 5:11:33 AM | selenumhimi My 
9 A 2013-11-05T08.09.20.012683.html 
@ #10 Nov5.201394931AM 国 seleniumscreenshotMyListsTesttest logged in users lists are saved as my lists- 
@ #9 Nov 5 20139:13.03AM 2013-11-05T08.09.19.955864.png 
@ #6 Nov 5.2013 90726AM 周 (talfiesinzip) 
locale ctl 人 HighlightAll MatchCase 其 
DD * S) 曲 | 











图 20-9: 访问 项 目的 工作 空间 





然后 查看 截图 ， 如 图 20-10 所 示 。 





seleniumscreenshot-MyListsTest.test_logged_in_users_lists_are_saved_as_my_lists-2013-11-05T08.09.19.9558| 局 
File Edit View History Bookmarks Tools Help 
| ~ seleniumscreenshot-MyListsT... | 外 | 


《 @ kins.ottg.eu:8080/job/Superlist iapter 17/ws/selen "© 图 cooole Q 业 合 Hr 


Superlists My lists Logged in as edith@email.com Log out 


My lists 


edith@email.com's lists 


。 Reticulate splines 





locale A Highlight All MatchCase 其 
@- * Se9 











图 20-10: 截图 看 起 来 正常 
好 吧 ， 截 图 并 没 提 供 多 少 帮助 。 
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20.6 一 个 常见 的 Selenium 问 题 : 条 件 竞 争 


只 要 在 Selenium 测试 中 遇 到 莫名 其 妙 的 失败 ， 最 说 得 通 的 解释 是 其 中 隐 含 了 条 件 芝 争 。 看 
一 下 导致 失败 的 那儿 行 测 试 : 

















functional tests/test my lists.py 
# 她 看 到 这 个 页 面 中 有 她 创建 的 清单 
# 而 且 清单 根据 第 一 个 待 办 事项 命名 
seLf .browser .find_eLement_by_Link_text('ReticuLate splines').click() 
self.assertEqual(self.browser.current_url, first list_url) 























点 击 “Reticulate splines” 之 后 ， 立 即 让 Selenium 检查 当前 页 面 的 URL 是 否 和 第 一 个 清单 
的 URL 相同 。 实 际 并 不 相同 : 























AssertionError: 'http://localhost:8081/accounts/edith@example.com/' != 
'http://localhost:8081/lists/1/' 











加 
| 


事 呢 ? 


看 起 来 当前 URL 还 是 “My Lists” 页 面 的 URL。 怎 么 


在 第 2 章 为 浏览 器 设置 了 impLicttty_watt， 而 且 我 说 过 这 种 做 法 并 不 可 靠 ， 还 记得 吗 ? 





对 Selenium 的 find_element_ 这 类 方法 来 说 ，implicitly_wait 还 算 能 够 正常 运行 ， 但 
browser .current_url 就 不 行 了 。Selenium 点 击 某 个 元 素 后 不 会 等 待 一 段 时 间 ， 所 以 浏览 器 
还 没完 全 加 载 新 页 面 ，current_url 也 就 仍 是 前 一 个 的 页 面 的 URL。 需 要 使 用 复杂 一 些 的 
等 待 代码 ， 类 似 于 在 各 个 Persona 页 面 中 使 用 的 那 种 。 


























现在 可 以 定义 一 个 辅助 函数 ， 实 现 等 待 功能 。 为 了 和 弄 清 怎么 定义 ， 可 以 先 看 一 下 我 希望 怎 
么 使 用 〈 由 外 而 内 ) : 








functional tests/test my _lists.py (ch201012) 


# 她 看 到 这 个 页 面 中 有 她 创建 的 清单 
# 而 且 清 单 根据 第 一 个 待 办 事项 命名 
self.browser .find element by_link_ text('Reticulate splines').click() 
self.wait_ for( 
Lambda: self.assertEqual(self.browser.current_url, first list_url) 









































) 


把 assertEqual 变 成 一 个 匿名 函数 ， 然 后 传 给 wait_for 辅助 方法 。 





functional tests/base.py (ch201013) 
import time 
from selenium.common.exceptions import WebDriverException 


[i 


def wait for(self, function with assertion, timeout=DEFAULT_WAIT): 
start_time = time.time() 
while time.time() - start time < timeout: 
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try: 
return function with_assertion() 
except (AssertionError, WebDriverException): 
time.sleep(0.1) 
# 再 试 一 次 ,如 果 还 不 行 就 抛 出 所 有 异常 
return function with _assertion() 
wait_for 试 着 运行 传人 的 函数 ， 如 果断 言 失败 ， 它 不 会 让 测试 失败 ,而 是 捕获 assertEqual 
通常 会 抛 出 的 AssertionError 异常 ， 稍 等 片刻 之 后 ， 再 循环 重新 运行 。whtte 循环 会 一 直 
运行 下 去 ， 直 到 超过 指定 的 超时 时 间 为 止 。wait_for 还 会 捕获 因为 页 面 中 没 出 现 某 个 元 素 
等 原因 导致 的 WebDriverException 异常 。 超 时 时 间 到 达 后 ，wait_for 还 会 再 运行 一 次 断言 
试 试 ， 不 过 这 一 次 没 放 入 try/except 语句 中 ， 所 以 如 果真 遇 到 了 AssertionError 异常 ， 测 
试 就 会 按照 相应 的 方式 失败 。 



































我 们 知道 ，Selenium 提供 了 Webdriverwait 作为 一 种 实现 等 待 的 工具 ， 但 是 
用 起 来 有 点 儿 限 制 。 自 己 动手 编写 的 版 本 ， 接 收 一 个 运行 unittest 断言 的 函 
数 ， 所 以 能 看 到 断言 输出 的 、 易 读 的 错误 消息 。 











超时 时 间 是 个 可 选 参数 ， 其 默认 值 是 一 个 常量 ， 下 面 就 在 base.py 中 添加 。 在 原先 的 
implicitly_wait 方法 中 也 使 用 这 个 常量 : 


nl 





functional tests/base.py (ch201014) 
[aa] 
DEFAULT_WAIT = 5 
SCREEN_DUMP_LOCATION = os.path.abspath( 
os.path.join(os.path.dirname(__file _), 'screendumps') 


) 


class FunctionalTest(StaticLiveServerCase): 


Es] 


def setUp(self): 
self.browser = webdriver.Firefox() 
self.browser.implicitly_wait(DEFAULT_WAIT) 








然后 再 次 运行 这 个 测试 ， 确 认 在 本 地 仍 能 通过 : 











$ python3 manage.py test functionaL_tests.test_my_Lists 


[ss] 


Ran 1 test in 9.594s 


OK 


保险 起 见 ， 还 要 故意 让 测试 失败 : 





持续 集成 | 359 


functional tests/test my _lists.py (ch201015) 


self.wait_ for( 
Lambda: self.assertEqual(self.browser.current_url, 'barf') 


) 
果不其然 ， 测 试 给 出 了 如 下 结果 : 
$ python3 manage.py test functional_tests.test my_lists 


bs] 
AssertionError: 'http://localhost:8081/lists/1/' != 'barf' 


还 看 到 页 面 停顿 了 三 秒 。 现 在 还 原 这 次 修改 ， 然 后 提交 改动 : 
$ git diff # base.py, test my_lists.py 


$ git commit -am"use wait for function for URL checks in my_lists" 
$ git push 





























然后 在 Jenkins 中 点 击 “Build now”( 现 在 构建 )， 再 次 构建 ， 确 认 测 试 是 否 能 通过 ， 如 图 
20-11 所 示 。 








Superlists [Jenkins] - Mozilla Firefox [3 
File Edit View History Bookmarks Tools Help 
盘 superlists [Jenkins] | 吴 | 


《 》 @ jenkins.ottg.eu:8 sts/ -@| 国 - Gooule QQ 业 合 Hr 
Jenkins (Qs bd 








Jenkins Superlists ENABLE AUTO REFRESH 
国 add description 


和 New Job 

二 

间 Superlists + 

多 ee s WwW Namel Last Success Last Failure 。 Last Duration 

局 -| Build History 

屿 ii， Superlists chapter 17 8 min 29 sec - #13 23 hr - 翅 1 min 15 sec 号 
Edit View 

Icon: SML 


© peete view Legend 国 Bssforal 国 assforfaiures RSS foriustlatestbuids 





Manage Jenkins 
2 Manage Jenkins 


Credentials 





筷 Wvews 
Build Queue 
No builds in the queue. 


Build Executor Status 
基 Status 

1 Idle 

2 lde 


Ee Help us localize this page Page generated: Nov 6, 2013 8-24-33 AM REST API Jenkins ver. 1.538 
国共 95) 曲 


























20-11: 前 景 更 明朗 
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Jenkins 使 用 蓝 色 表示 构建 成 功 。 居 然 没 用 绿色 ， 真 让 人 失望 。 不 过 看 到 太阳 从 云 中 探 出 头 
来 ， 心 情 又 舒畅 了 。 这 个 图 标 表示 成 功 构 建 和 失败 构建 的 平均 比值 正在 发 生变 化 ， 而 且 是 
向 好 的 一 面 发 展 。 


























20.7 ”使 用 PhantomJS 运 行 QUnit JavaScript 测 试 
差点 儿 忘 了 还 有 一 种 测试 一 一 JavaScript 测试 。 现 在 的 “测试 运行 程序 ”是 真正 的 web 浏 
览 器 。 若 想 在 Jenkins 中 运行 JavaScript 测试 ， 需 要 一 种 命令 行 测 试 运行 程序 。 借 此 机 会 使 
用 PhantomJS 。 














20.7.1 安装 node 


别 再 假装 用 不 到 JavaScript 了 ， 做 Web 开发 ， 离 不 开 它 。 因 此 ， 要 在 自己 的 电脑 中 安装 
node.js， 这 一 步 不 可 避免 。 











安装 方法 参见 node.js 下 载 页 面 (http:/nodejs.org/download/) 中 的 说 明 。Windows 和 Mac 
系统 都 有 安装 包 ， 而 且 各 种 流行 的 Linux 发 行 版 都 有 各 自 的 包 “。 


安装 好 node 之 后 ， 可 以 执行 下 面 的 命令 安装 PhantomJS : 








$ npm instaLL -g phantomjs # -g 的 意思 是 系统 全 局 安装 ,可 能 需要 使 用 sudo 
接 下 来 要 下 载 QUnit/PhantomJS 测试 运行 程序 。 测 试 运行 程序 有 很 多 (为 了 运行 本 书 中 
的 QUnit 测试 ， 我 甚至 还 自己 写 过 一 个 简单 的 )， 不 过 最 好 使 用 QUnit 插件 页 面 (http:/ 
qunitjs.com/plugins/) 提 到 的 那个 。 写 作 本 书 时 ， 这 个 运行 程序 的 仓库 地 址 是 https://github. 
com/jonkemp/qunit-phantomjs-runner。 只 需要 一 个 文件 ，runner.js。 


ou 









































最 终 得 到 的 文件 夹 结构 如 下 : 





$ tree superlists/static/tests/ 
superlists/static/tests/ 

一 qunit.css 

一 qunit.js 

| 一 runner.js 


-一 sinon.js 
0 directories, 4 files 
试 一 下 这 个 运行 程序 ; 


$ phantomjs superlists/static/tests/runner.js lists/static/tests/tests.html 
Took 24ms to run 2 tests. 2 passed, 0 failed. 








注 4: 一 定 要 下 载 最 新 版 。 在 Ubuntu 中 别 用 默认 的 包 ， 要 使 用 PPA。 
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$ phantomjs superlists/static/tests/runner.js accounts/static/tests/tests.htmL 
Took 29ms to run 11 tests. 11 passed, 0 failed. 


保险 起 见 ， 故 意 破坏 一 个 测试 : 


lists/static/list.js (ch201019) 


$('input').on('keypress', function () { 
//$('.has-error').hide(); 
]); 


有 果然， 测试 失败 了 : 


$ phantomjs superlists/static/tests/runner.js lists/static/tests/tests.html 
Test failed: undefined: errors should be hidden on keypress 

Failed assertion: expected: false, but was: true 

at file:///workspace/superlists/superlists/static/tests/qunit.js:556 

at file:///workspace/superlists/lists/static/tests/tests.html:26 

at file:///workspace/superlists/superlists/static/tests/qunit.js:203 

at file:///workspace/superlists/superlists/static/tests/qunit.js:361 

at process 
(file:///workspace/superlists/superlists/static/tests/qunit.js:1453) 

at file:///workspace/superlists/superlists/static/tests/qunit.js:479 
Took 27ms to run 2 tests. 1 passed, 1 failed. 


很 好 ! 再 改 回去 ， 提 交 并 推送 运行 程序 ， 然 后 将 其 添加 到 Jenkins 的 构建 步骤 中 





$ git checkout lists/static/list.js 

$ git add superlists/static/tests/runner.js 

$ git commit -m"Add phantomjs test runner for javascript tests" 
$ git push 


20.7.2 ”在 Jenkins 中 添加 构建 步骤 
再 次 编辑 项 目 配置 ， 为 每 个 JavaScript 测试 文件 添加 一 个 构建 步骤 ， 如 图 20-12 所 示 。 











Execute shell 


Command | 











20-12: 为 JavaScript 单元 测试 添加 构建 步骤 


还 要 在 服务 器 中 安装 PhantomJS : 
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elspeth@server:$ sudo add-apt-repository -y ppa:chris-Lea/node.js 
elspeth@server:$ sudo apt-get update 

elspeth@server:$ sudo apt-get install nodejs 

elspeth@server:$ sudo npm install -g phantomjs 


至 此 ， 编 写 了 完整 的 CI 构建 步骤 ， 能 运行 所 有 测试 ! 


Started by user harry 

Building in workspace /var/Lib/jenkins/jobs/SuperLists/workspace 

Fetching changes from the remote Git repository 

Fetching upstream changes from https://github.com/hjwp/book-example.git 

Checking out Revision 936a484038194b289312ff62f10d24e6a054fb29 (origin/chapter_1 
Xvfb starting$ /usr/bin/Xvfb :1 -screen 0 1024x768x24 -fbdir /var/Lib/jenkins/20 
[workspace] $ /bin/sh -xe /tmp/shiningpanda7092102504259037999.sh 


+ pip install -r requirements.txt 


[...] 


+ python manage.py test lists 


Ran 33 tests in 0.229s 


OK 
Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 


+ python manage.py test accounts 


Ran 18 tests in 0.078s 


OK 
Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 


[workspace] $ /bin/sh -xe /tmp/hudson2967478575201471277.sh 

+ phantomjs superlists/static/tests/runner.js lists/static/tests/tests.html 
Took 32ms to run 2 tests. 2 passed, 0 failed. 

+ phantomjs superlists/static/tests/runner.js accounts/static/tests/tests.html 
Took 47ms to run 11 tests. 11 passed, 0 failed. 


[workspace] $ /bin/sh -xe /tmp/shiningpanda7526089957247195819.sh 
+ pip install selenium 
Requirement already satisfied (use --upgrade to upgrade): selenium in /var/Lib/ 


Cleaning up... 
[workspace] $ /bin/sh -xe /tmp/shiningpanda2420240268202055029.sh 
+ python manage.py test functional_tests 


Ran 7 tests in 76.804s 


OK 
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如 果 我 大 懒 ， 不 想 在 自己 的 设 


ss 











中 运行 整个 测试 组 件 ，CI 服务 器 可 以 代劳 一 一 真是 太 好 
测试 山羊 的 另 一 个 代理 人 正在 网 络 空间 里 监视 我 们 呢 ! 














20.8 “CI 服务 器 能 完成 的 其 他 操作 


Jenkins 和 CI 服务 器 的 作用 只 介绍 了 皮毛 。 例 如 ， 还 可 以 让 CI 服务 器 在 监控 仓库 的 新 提交 





方 








下 变 得 更 智能 。 








或 者 做 些 更 有 趣 的 事 ， 除 了 运行 普通 的 功能 测试 之 外 ， 还 可 以 使 用 CI 服务 器 自动 运行 过 





渡 服 务 器 中 的 测试 。 如 果 所 有 功能 测试 都 能 通过 ， 你 可 以 添 力 


上 一 个 构建 步骤 ， 把 代码 部 署 





到 过 渡 服 务 器 中 ， 然 后 在 过 渡 服 务 器 中 再 运行 功能 测试 。 这 样 整个 过 程 又 多 了 一 步 可 以 自 
动 完成 ， 而 且 可 以 保证 过 渡 服 务 器 始终 使 用 最 新 的 代码 。 








有 些 人 甚至 使 用 CI 服务 器 把 最 新 发 布 的 代码 部 署 到 生产 服务 器 中 。 








Cl 和 Selenium 最 佳 实践 
尽早 为 自己 的 项 目 搭建 CI 服务 器 
一 旦 运行 功能 测试 所 花 的 时 间 超过 几 秒 钟 ， 你 就 会 发 现 自己 根本 不 想 再 运行 了 。 把 
这 个 任务 交 给 CI 服务 器 吧 ， 确 保 所 有 测试 都 能 在 某 处 运行 。 


测试 失败 时 截图 和 转 储 HTML 
如 果 你 能 看 到 测试 失败 时 网 页 是 什么 样 ， 调 试 就 容易 得 多 。 截 图 和 和 转 储 HTML 有 
助 于 调试 CI 服务 器 中 的 失败 ,而且 对 本 地 运行 的 测试 也 很 有 用 。 


在 Selenium 测试 中 等 待 一 段 时 间 

Selenium 提供 的 implicitly_wait 只 能 用 于 find_element_ 这 类 遂 数 ,但 也 不 可 靠 
(也 能 找到 前 一 个 页 面 中 的 元 素 )。 定 义 一 个 辅助 函数 wait_for， 在 网 站 中 执行 的 两 
次 操作 之 间 调 用 ， 然 后 等 待 一 段 时 间 ， 让 操作 生效 。 


想 办 法 把 CI 和 过 渡 服 务 器 连接 起 来 

使 用 LiveServerTestCase 的 测试 在 开发 环境 中 不 会 遇 到 什么 问题 ， 但 若 想得到 十 足 
的 保障 ， 就 要 在 真正 的 服务 器 中 运行 测试 。 想 办 法 让 CI 服务 器 把 代码 部 署 到 过 洲 
服务 器 中 ， 然 后 在 过 渡 服 务 器 中 运行 功能 测试 。 这 么 做 还 有 个 附带 好 处 : 测试 自动 
化 部 署 脚本 是 否 可 用 。 
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简单 的 社会 化 功能 、 
页 面 模式 ， 以 及 练习 





“现在 一 切 都 要 社会 化 ”的 调侃 是 不 是 有 点 过 时 了 ? 不 管 怎样 ， 现 在 一 切 都 要 是 经 过 A/B 
测试 和 大 数据 分 析 能 得 到 超 多 点 击 量 的 类 似 “ 创 意 导 师 认 为 将 颠覆 你 观念 的 十 件 事 ” 的 列 
表 。 不 管 是 否 真能 激发 创意 ， 列 表 都 更 容易 传播 。 那 我 们 就 让 用 户 能 和 其 他 人 协作 完成 他 
们 的 列表 吧 。 














在 实现 这 个 功能 的 过 程 中 ， 先 使 用 前 一 章 学 到 的 Selenium 交互 等 待 模式 改进 功能 测试 ， 然 
后 试用 页 面 对 象 模式 (Page Object pattern ) 。 

















不 告诉 你 具体 做 法 ， 而 是 让 你 自己 编写 单元 测试 和 应 用 代码 。 别 担心 ， 我 不 会 让 你 完全 自 
己 动手 ,会 告诉 你 大 概 步 又 和 一 些 提示 。 


21.1 有 多 个 用 户 以 及 使 用 addCleanup 的 功能 
测试 


开始 吧 。 这 个 功能 测试 需要 两 个 用 户 : 














functional tests/test_sharing.py 


from selenium import webdriver 
from .base import FunctionalTest 
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def quit if_possible(browser): 
try: browser .quit() 
except: pass 


class SharingTest(FunctionalTest): 


def test_logged_in users_lists are_saved as my_lists(self): 
# 伊 迪 丝 是 已 登录 用 户 
self.create_pre_authenticated_session('edith@example.com') 
edith_browser = self.browser 
self.addCleanup(lambda: quit if_ possible(edith_ browser)) 

















# 她 的 朋友 oniciferous 也 在 使 用 这 个 清单 网 站 

oni_browser = webdriver.Firefox() 

self.addCleanup(lambda: quit if_possible(oni_ browser)) 
self.browser = oni_browser 
self.create_pre_authenticated_session('oniciferous@example.com') 











# 伊 迪 丝 访问 首页 ,新建 一 个 清单 
seLf .browser = edith_browser 
seLf .browser .get(seLf.server_UrL) 

self.get item input_ box().send keys('Get help\n') 

















# 她 看 到 “分 享 这 个 清单 ”选项 
share_box = self.browser.find element by_css_selector('input[name=email]') 
self.assertEqual( 

share_box.get_attribute('placeholder ' ) ， 

"your-friendQexampLe.com' 


) 


一 节 有 个 功能 值得 注意 : addCleanup 国 数 ， 它 的 文档 可 以 在 这 里 (https:/docs.python. 
re beer Liles html#unittest.TestCase.addCleanup) 查看 。 这 个 函数 可 以 代 赫 tearDown 
函数 ， 清 理 测 试 中 使 用 的 资源 。 如 果 资 源 在 测试 运行 的 过 程 中 才 用 到 ， 最 好 使 用 
addCleanup 函数 ， 因 为 这 样 就 不 用 在 tearDown 函数 中 花 时 间 区 分 哪些 资源 需要 清理 ， 哪 些 
不 需要 清理 。 




















addCLeanup 国 数 在 tearDown 国 数 之 后 运行 ， 所 以 在 quit_if_possible 国 数 中 才 要 使 用 
try/except 语句 ， 因 为 不 管 edith_browser 和 oni_browser 中 哪 一 个 的 值 是 seLf.browser， 
测试 结束 时 tearDown 函数 都 会 关闭 这 个 浏览 器 。 




















还 要 把 测试 方法 create_pre_authenticated_session 从 test_my_lists.py 移 到 base.py 中 。 
好 了 ， 看 一 下 测试 结果 如 何 : 


$ python3 manage.py test functional_tests.test_sharing 
[ssa] 
Traceback (most recent call last): 
File "/workspace/superlists/functional_tests/test_sharing.py", line 29, in 





test_Logged_in_users_Lists_are_saved_as_my_Lists 

share_box = self.browser.find element_ by_css_selector('input[name=email]') 
Lass] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"css selector","selector":"input[name=email]"}' ;} 











太 好 了 ， 看 样子 可 以 创建 两 个 用 户 会 话 ， 得 到 了 一 个 意料 之 中 的 失败 ， 
写 电子 邮件 地 址 的 输入 框 ， 无 法 分 享 给 别人 。 





六 





为 页 面 中 没有 填 














现在 做 一 次 提交 ， 因 为 至 少 已 经 编写 了 一 个 占 位 功能 测试 ， 也 移动 了 create_pre_ 
authenticated_session 国 数 ， 接 下 来 要 重 构 功能 测试 ， 


$ git add functional_tests 
$ git commit -m "New FT for sharing, move session creation stuff to base" 


21.2 ”实现 Selenium 交 互 等 待 模式 
继续 之 前 ， 先 仔细 看 一 下 现在 功能 测试 中 与 网 站 交互 的 代码 : 





functional tests/test_sharing.py 
# 伊 迪 丝 访问 首页 ,新 建 一 个 清单 
seLf .browser = edith_browser 
seLf .browser .get(seLf.server_UrL) 
seLf .get_item_input_box().send_keys('Get help\n') #@ 





# 她 看 到 “分 享 这 个 清单 ”选项 
share_box = self.browser.find element by_css_selector('input[name=email]') #@ 
self.assertEqual( 

share_box.get_attribute('pLacehoLder ' ) ， 

"your-friendQexampLe.com' 





) 
@ 0 与 网 站 交互 。 
@ 猜想 页 面 更 新 后 的 状态 。 


读 过 前 一 章 我 们 知道 ， 与 网 站 交互 后 (例如 使 用 send_keys)， 过 多 猜想 浏览 器 的 状态 有 
风险 。 理 论 上 ， 如 果 fiind_element_by_css_selector 第 一 次 没有 找到 input[name=email]， 
implicitly_wait 在 后 台 会 再 试 几 次 。 但 重 试 的 过 程 中 可 能 出 错 ， 假 如 前 一 个 页 面 中 也 有 
属性 为 name=email 的 输入 框 ， 只 是 占 位 文本 不 同 ， 想 想 会 发 生 什 么 ? 测试 会 莫名 其 妙 地 失 
败 ， 因 为 理论 上 ， 在 新 页 面 加 载 的 同时 ，Selenium 也 可 以 获取 前 一 个 页 面 中 的 元 素 ， 很 可 
能 会 抛 出 StaleElementException 异常 。 









































如 果 Selenium 意外 抛 出 StaleElementException 异常 ， 通 常 是 因为 有 某 种 条 
件 竞 争 。 或 许 你 应 该 使 用 显 式 的 交互 等 待 模式 。 
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因此 ， 如 果 交 互 后 想 立 即 检查 效果 ， 一 定 要 谨慎 。 可 以 沿用 wait_for 函数 中 使 用 的 等 待 方 
式 ， 把 上 述 代码 改写 成 





functional tests/test_sharing.py 
self.get item input_ box().send keys('Get help\n') 


# 她 看 到 "分 享 这 个 清单 "选项 
self.wait_ for( 
Lambda: self.assertEqual( 
self.browser .find element_ by_css_selector( 
'input[name=email]' 
).get_attribute('placeholder'), 
'your -friend@example.com’ 


21.3 页面 模式 


你 知道 怎么 做 更 好 吗 ?这 里 可 以 使 用 “三 则 重 构 ” 原 则 。 这 个 测试 以 及 很 多 其 他 测试 ， 开 
头 都 是 用 户 新 建 一 个 清单 。 定 义 一 个 辅助 函数 ， 命 名 为 start_new_List， 让 它 调用 watt_ 


for 以 及 输入 清单 中 的 待 办 事项 ， 怎 么 样 ? 





























我 们 已 经 知道 如 何在 FunctionatLTest 基 类 中 使 用 辅助 方法 ， 可 如 果 辅 助 函 数 越 来 越 多 ， 这 
个 类 会 变 得 很 腾 肿 。 我 曾经 写 过 一 个 功能 测试 基 类 ， 代 码 超过 1500 行 ， 相 当 庞 大 。 


分 拆 功 能 测试 的 辅助 代码 有 个 公认 可 行 的 方式 ， 叫 作 页 面 模 式 (http://www.seleniumhq.org/ 
docs/06_test_design_considerations.jsp#page-object-design-pattern)。 在 页 面 模式 中 要 定义 多 
个 对 象 ， 分 别 表示 网 站 中 不 同 的 页 面 ， 而 且 只 能 在 这 些 对 象 中 存储 与 页 面 交互 的 方式 。 


看 一 下 如 何 为 首页 和 清单 页 面 创建 页 面 对 象 。 首 页 的 页 面 对 象 如 下 : 




































































functional tests/home and list pages.py 
class HomePage(object) : 


def _init (self, test): 
seLf .test = test #0 


def go_to_ home page(self): #@ 
seLf .test.browser .get(self.test.server_url) 
self.test.wait for(self.get item input) 
return self #@ 


def get item input(self): 
return self.test.browser.find_ element_ by_id('id text') 


def start new_ list(self, item text): #@ 
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seLf .go_to_home_page() 

inputbox = self.get item input() 
inputbox.send_keys(item text + '\n') 

list page = ListPage(seLf .test) #@ 

list page.wait for_new item in list(item text, 1) #@ 
return List_page #@ 


使 用 表示 当前 测试 的 对 象 初始 化 ， 这 样 就 能 声明 断言 ， 通 过 self.test.browser 访问 浏 

览 器 实例 ， 也 能 使 用 wait_for 函数 。 

@ 大 多 数 页 面 对 象 都 有 一 个 方法 用 于 访问 这 个 页 面 。 注 意 ， 这 个 方法 实现 了 交互 等 待 模 
式 一 一 首先 调用 get 方法 获取 这 个 页 面 的 URL， 然 后 等 待 我 们 知道 会 在 首页 中 显示 的 

元 素 出 现 。 


© 


















































@ 返回 setf 只 是 为 了 操作 方便 。 这 么 做 可 以 使 用 方法 串 接 (https://en.wikipedia.org/wiki/ 
Method_chaining ) 。 














@ 这 是 用 于 新 建 清单 的 方法 。 访 问 首 页 ， 找 到 输入 框 ， 输 入 待 办 事项 ， 再 按 回 车 键 。 然 后 
等 待 一 段 时 间 ， 和 确保 交 互 完成 。 不 过 可 以 看 出 ， 这 次 等 待 其 实 发 生 在 另 一 个 页 面 对 象 中 。 

















@ ListPage 稍 后 定义 ， 初 始 化 的 方式 类 似 于 HomePage。 


@ 调用 ListPage 类 中 的 wait_for_new_item_in_List 方法 ， 指 定期 望 看 到 的 待 办 事项 文本 
以 及 在 清单 中 的 排 位 。 


@ 最 后 ， 把 list_page 对 象 返 回 给 调用 者 ， 因 为 调用 者 可 能 会 用 到 这 个 对 象 〈《 稍 后 就 会 
， 

















ListPage 类 的 定义 如 下 : 


functional tests/home and list pages.py (ch211006) 
[sa 


class ListPage(object) : 


def _init (self, test): 
seLf .test = test 


def get_List_tabLe_rows(seLf) : 
return self.test.browser.find elements by_css_selector( 
'#id_list table tr' 
) 


def wait for_new item in list(self, item text, position): 
expected_row = '{}: {}'.format(position, item text) 
self.test.wait for(lambda: self.test.assertIn( 
expected_row, 
[row.text for row in self.get_ list table_rows()] 


)) 
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下 


一 般 来 说 ， 最 好 把 页 面 对 象 放 在 各 自 的 文件 中 。 这 里 ，HomePage 和 ListPage 
联系 比较 紧密 ， 所 以 可 以 放 在 同一 个 文件 中 。 











UD 











看 看 一 下 如 何在 测试 中 使 用 页 面 对 象 : 








functional tests/test_sharing.py (ch211007) 


from .home_and_list pages import HomePage 


[a 








# 伊 迪 丝 访问 首页 ,新建 一 个 清单 
self.browser = edith_browser 
list_page = HomepPage(self).start_new_list('Get help') 


























继续 改写 测试 ， 只 要 想 访问 列表 页 面 中 的 元 素 ， 就 使 用 页 面 对 象 : 




















functional tests/test_sharing.py (ch211008) 
# 她 看 到 “分 享 这 个 清单 ”选项 
share_box = list page.get_ share_box() 
self.assertEqual( 
share_box.get_attribute('pLacehoLder ' ) ， 
"your-friendQexampLe.com' 


) 
# 她 分 享 自 己 的 清单 之 后 ,页 面 更 新 了 


# 提示 已 经 分 享 给 Oniciferous 
list page.share_list with('oniciferous@example.com') 


我 们 要 在 ListPage 类 中 添加 以 下 三 个 方法 : 


functional tests/home and list pages.py (ch211009) 


def get_share_box(self): 
return self.test.browser.find_ element by_css_selector( 
'input[name=email]' 


) 


def get_shared with list(self): 
return self.test.browser.find elements by_css_selector( 
'.list-sharee' 


» 


def share_list with(self, email): 
self.get_share_box().send_keys(email + '\n') 
self.test.wait_ for(lambda: seLf.test.assertIn( 
email, 
[item.text for item in self.get_ shared with list()] 
)) 


页 面 模型 背后 的 思想 是 ， 把 网 站 中 某 个 页 面 的 所 有 信息 都 集中 放 在 一 个 地 方 ， 如 果 以 后 想 
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要 修改 这 个 页 面 ， 比 如 简单 的 调整 HTML 布局 ， 功 能 测试 只 需 改动 一 个 地 方 ， 不 用 到 处 修 


改 多 个 功能 测试 。 


接 下 来 要 继续 重 构 其 他 功能 测试 。 在 这 里 我 就 不 细 说 了 ， 你 可 以 试 着 自己 完成 ， 感 受 一 下 





在 DRY 原则 和 测试 可 读 性 方面 要 做 哪些 折 中 处 理 。 








21.4 ”扩展 功能 测试 测试 第 二 个 用 户 和 “My Lists” 


页 面 




















把 分 享 功能 的 用 户 故 事 写 得 更 详细 点 儿 。 伊 迪 丝 在 她 的 清单 页 面 看 到 这 个 清单 已 经 分 享 给 

















Oniciferous， 然 后 Oniciferous 登录 ， 看 到 这 个 清单 出 现在 “My Lists” 页 面 中 ， 或 许 显示 


在 “分 享 给 我 的 清单 ”中 : 











functional tests/test_ sharing.py (ch211010) 


[...] 


list_page.share_list with('oniciferous@example.com') 


# 现在 Oniciferous 在 他 的 浏览 器 中 访问 清单 页 面 
self.browser = oni_browser 











HomePage(self).go_to home page().go_ to my_lists page() 




















# 他 看 到 了 伊 迪 丝 分 享 的 清单 
self.browser.find element_ by_link_ text('Get 


为 此 ， 要 在 HomePage 类 中 再 定义 一 个 方法 : 


help').click() 


functional tests/home and list pages.py (ch211011) 


class HomePage(object ) : 


区 


def go to my_lists page(self): 


self.test.browser.find element by_link text('My lists').click() 
self.test.wait for(lambda: seLf.test.assertEquaL( 
seLf .test.browser .find_eLement_by_tag_name('h1' ) .text， 


'My Lists 
)) 


这 个 方法 最 好 放 到 test_my_lists.py 中 ， 或 许 还 可 以 再 定义 一 个 MyListsPage 类 。 这 个 任务 


作为 练习 留 给 读者 完成 。 





现在 ，Oniciferous 也 可 以 在 这 个 清单 中 添加 待 办 导 








二 


项 : 


functional tests/test_sharing.py (ch211012) 


# 在 清单 页 面 ,Oniciferous 看 到 这 个 清单 属于 伊 迪 丝 














self.wait for(lambda: self.assertEqual( 
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List_page.get_List_owner()， 
"edithQexampLe.com' 


)) 


# 他 在 这 个 清单 中 添加 一 个 待 办 事项 
list page.add new item('Hi Edith!') 








# 伊 迪 丝 刷 新 页 面 后 ,看 到 Oniciferous 添 加 的 内 容 

seLf .browser = edith_browser 

seLf .browser .refresh() 
List_page.wait_for_new_item_in_List('HL Edith!', 2) 


为 此 ， 要 在 页 面 对 象 中 再 定义 儿 个 方法 : 


functional tests/home_and list pages.py (ch211013) 


ITEM_INPUT_ID = 'id_text' 
[ee 


class HomePage(object) : 


[...] 


def get item input(self): 
return self.test.browser.find_ element_by_id(ITEM_INPUT_ID) 


class ListPage(object) : 


[...] 


def get item input(self): 
return self.test.browser.find_element_by_id(ITEM_INPUT_ID) 


def add new_item(self, item text): 
current_pos = len(self.get list table_rows()) 
self.get item input().send keys(item text + '\n') 
self.wait for_new item in list(item text, current pos + 1) 


def get list owner(self): 
return self.test.browser.find element_ by_id('id_ list _ owner').text 


早 就 该 运行 功能 测试 了 ， 看 看 这 些 测 试 能 


$ python3 manage.py test functional_tests.test_sharing 


share_box = list page.get_ share_box() 


E32] 
selenium.common.exceptions.NoSuchElementException: Message: 'Unable to Locate 
element: {"method":"css selector","selector":"input[name=email]"}’' 


个 失败 在 预料 之 中 ， 因 为 还 没 在 页 面 中 添加 输入 框 ， 填写 电子 邮件 地 址 ， 分 享 给 别人 。 
J 




















$ git add functional_tests 
$ git commit -m "Create Page objects for Home and List pages, use in sharing FT" 


21.5 留 给 读者 的 练习 
实现 这 个 新 功能 所 需 的 步骤 大 致 如 下 : 


(在 listhtml 添加 一 个 新 区 域 ， 先 写 一 个 表单 ， 表 单 中 包含 一 个 输入 框 ， 用 来 输入 电子 邮 
件 地 址 。 功 能 测试 应 该 会 前 进一步 。 


























(2) 需 要 一 个 视图 ， 处 理 表单 。 先 在 模板 中 定义 URL， 例 如 lists//share。 





(3) 然后， 编写 第 一 个 单元 测试 ， 驱 动 我 们 定义 占 位 视图 。 我 们 希望 这 个 视图 处 理 POST 
请 求 ， 响 应 是 重 定向 ， 指 向 清单 页 面 ， 所 以 这 个 测试 可 以 命名 为 ShareListTest.test_ 


post_redirects to_lists page, 


























(4) 编写 占 位 视图 ， 只 需 两 行 代 码 ， 一 行 用 于 查找 清单 ， 一 行 用 于 重 定向 。 

















(5) 可 以 再 编写 一 个 单元 测试 ， 在 测试 中 创建 一 个 用 户 和 一 个 清单 ， 在 POST 请 求 中 发 送 电 
子 邮 件 地 址 ， 然 后 检查 List_.shared_with.all() (类 似 于 “My Lists” 页 面 使 用 的 那个 
ORM 用 法 ) 中 是 否 包含 这 个 用 户 。shared_with 属性 还 不 存在 ， 我 们 使 用 的 是 由 外 而 内 
的 方式 。 























(6) 所 以 在 这 个 测试 通过 之 前 ， 要 下 移 到 模型 层 。 下 一 个 测试 要 写 入 test_models.py 中 。 在 
这 个 测试 中 ， 可 以 检查 清单 能 否 响应 shared_with.add 方法 。 这 个 方法 的 参数 是 用 户 的 
电子 邮件 地 址 。 然 后 检查 清单 的 shared_with.all() 查询 集合 中 是 否 包含 这 个 用 户 。 














(7) 然后 需要 用 到 ManyToManyField。 或 许 你 会 看 到 一 个 错误 消息 ， 提 示 related_name 有 冲 
突 ， 查 阅 Django 的 文档 之 后 你 会 找到 解决 办 法 。 





(8) 需要 执行 一 次 数据 库 迁 移 。 





(9) 然后 ， 模 型 测试 应 该 可 以 通过 。 回 过 头 来 修正 视图 测试 。 











(10) 可 能 会 发 现 重 定向 视图 的 测试 失败 ， 因 为 视图 发 送 的 POST 请 求 无 效 。 可 以 选择 忽略 
无 效 的 输入 ， 也 可 以 调整 测试 ， 发 送 有 效 的 POST 请 求 。 




















(11) 然后 回 到 模板 层 。 My Lists” 页 面 需 要 一 个 <ul> 元 素 ， 使 用 for 循环 列 出 分 享 给 这 
个 用 户 的 清单 。 还 想 在 清单 页 面 显 示 这 个 清单 分 享 给 谁 了 ， 并 注 明 这 个 清单 的 属 主 是 
谁 。 各 元 素 的 类 和 ID 参见 功能 测试 。 如 果 需 要 ， 还 可 以 为 这 几 个 需求 编写 简单 的 单 
元 测试 。 










































































(12) 执行 runserver 命令 让 网 站 运行 起 来 ， 或 许 能 帮助 你 解决 问题 ， 以 及 调整 布局 和 外 观 。 
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如 果 使 用 隐私 浏览 器 会 话 ， 可 以 同时 登录 多 个 用 户 。 


最 终 ， 可 能 会 得 到 类 似 图 21-1 所 示 的 页 面 。 








Enter a to-do item 
1: new list 
List shared with: Share this list 
es harry.percival@grmail.com [vour@riends-emai com 





se harry@mockmyid.com 











图 21-1: 分 享 清 





页 面 模式 以 及 真正 留 给 读者 的 练习 
。 在 功能 测试 中 运用 DRY 原则 
功能 测试 多 起 来 后 ， 就 会 发 现 不 同 的 测试 使 用 了 UI 的 同一 部 分 。 尽 量 避 免 在 多 个 
功能 测试 中 使 用 重复 的 常量 ， 例 如 某 个 UI 元 素 HTML 代码 中 的 ID 和 类 。 





。 页 面 模式 
把 辅助 方法 移 到 FunctionalTest 基 类 中 会 把 这 个 类 变 得 脐 肿 不 堪 。 可 以 考虑 把 处 理 
网 站 特定 部 分 的 全 部 逻辑 保存 到 单独 的 页 面 对 象 中 。 


。 留 给 读者 的 练习 
希望 你 真 的 会 做 这 个 练习 | 试 着 遵守 由 外 而 内 的 开发 方式 ， 如 果 卡 住 了 ,偶尔 也 可 
以 手动 测试 。 当 然 ， 真正 留 给 读者 的 练习 是 ， 在 你 的 下 一 个 项 目 中 使 用 TDD。 和 项 
望 它 能 给 你 带 来 愉悦 的 体验 | 











下 一 章 做 个 总 结 ， 探 讨 测 试 的 “最 佳 实践 ”。 
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第 22 章 


测试 运行 速度 的 快慢 和 炽热 的 各区 





“数据 库 是 炽热 的 宕 桨 | ” 
Casey Kinsey (https://www.youtube.com/watch?v=bsmFVb8guMU) 








在 第 19 章 之 前 ， 书 中 儿 乎 所 有 的 “单元 ”测试 或 许 都 应 该 叫 作 整合 测试 ， 因 为 这 些 测 试 
要 不 依赖 于 数据 库 ， 要 不 使 用 Django 测试 客户 端 ， 请 求 、 响 应 和 视图 函数 之 间 的 中 间 层 
有 太 多 细 广 都 被 隐藏 了 。 


有 种 说 法 认为 ， 真 正 的 单元 测试 一 定 要 隔离 ， 因 为 单元 测试 只 应 该 测试 软件 单独 的 一 
部 分 。 


























一 些 TDD 老手 说 ， 你 应 该 尽力 编写 完全 隔离 的 单元 测试 ， 而 不 要 编写 整合 测试 。 测 试 社 
区 一 直 都 有 这 样 的 和 争论， 有 时 还 很 白热化 。 











我 只 是 个 狂妄 的 年 轻 人 ， 对 这 场 争论 的 细 市 并 不 太 了 解 。 但 在 这 一 章 里 ， 我 想 试 着 分 析 人 
门 为 什么 如 此 在 意 这 件 事 ， 然 后 给 出 一 些 建 议 ， 告 诉 你 什么 时 候 勉强 可 以 使 用 整合 测试 
(我 承认 很 多 时 候 我 都 是 这 样 做 的 )， 什 么 时 候 值 得 争取 编写 更 纯粹 的 单元 测试 。 











术语 : 测试 的 不 同类 型 
。 隔离 测试 (纯粹 的 单元 测试 ) 与 整合 测试 
单元 测试 的 主要 作用 应 该 是 验证 应 用 的 逻辑 是 否 正 确 。 陪 离 测 试 只 能 测试 一 部 分 代 
码 ， 测 试 是 否 通 过 与 其 他 任何 外 部 代码 都 没有 关系 。 我 所 说 的 纯粹 的 单元 测试 是 
指 ， 对 一 个 函数 的 测试 而 言 ， 只 有 这 个 函数 能 让 测试 失败 。 如 果 这 个 函数 依赖 于 其 
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他 系统 且 破坏 这 个 系统 会 导致 测试 失败 ， 就 说 明 这 是 整合 测试 。 这 个 系统 可 以 是 外 
部 系统 ， 例 如 数据 库 ， 也 可 以 是 我 们 无 法 控制 的 另 一 个 函数 。 不 管 怎 样 ， 只 要 破坏 
系统 会 导致 测试 失败 ， 这 个 测试 就 没有 完全 隔离 ， 因 此 也 就 不 是 纯粹 的 单元 测试 。 
整合 测试 并 非 不 好 ， 只 不 过 可 能 意味 着 同时 测试 两 个 功能 。 


。 集成 测试 


集成 测试 用 于 检查 被 你 控制 的 代码 是 否 能 和 你 无 法 控制 的 外 部 系统 完好 集成 。 集 成 
测试 往往 也 是 整合 测试 。 





。 系统 测试 
如 果 说 集成 测试 检查 的 是 与 外 部 系统 的 集成 情况 ， 那 么 系统 测试 就 是 检查 应 用 内 部 
多 个 系统 之 间 的 集成 情况 。 例 如 ， 检 查 数 据 库 、 静 态 文 件 和 服务 器 配置 在 一 起 是 否 
能 正常 运行 。 

。 功能 测试 和 验收 测试 
验收 测试 的 作用 是 从 用 户 的 角度 检查 系统 是 否 能 正常 运行 (“用户 能 接受 这 种 行为 
吗 ?“)。 验 收 测试 很 难 不 写成 全 栈 痛 到 端 测试 。 在 前 文中 ， 使 用 功能 测试 代替 验收 
测试 和 系统 测试 。 








请 原谅 我 的 自命 不 几 ， 下 面 我 要 使 用 一 些 哲学 术语 ， 通 过 黑 格 尔 辩证 法 详细 分 析 。 








。 正题 : 纯粹 的 单元 测试 运行 速度 快 ， 

。 反 题 : 编写 纯粹 的 单元 测试 有 哪些 风险 ， 

。 合 题 : 讨论 一 些 最 佳 实践 ， 例 如 “端口 和 适 配 右 ”“ 国 数 式 核心 ， 命 令 式 外 壳 ”， 以 及 我 
们 到 底 想 从 测试 中 得 到 什么 。 


22.1 正题 : 单元 测试 除了 运行 速度 超 快 之 外 还 有 
其 他 优势 


关于 单元 测试 你 经 常会 听 到 一 种 说 法 : 单元 测试 运行 速度 快 多 了 。 其 实 
元 测试 的 主要 优势 ， 不 过 速度 的 确 值得 一 谈 。 


22.1.1 测试 运行 得 越 快 ， 开 发 速度 越 快 
在 其 他 条 件 相同 的 情况 下 ， 单 元 测试 运行 的 速度 越 快 越 好 。 可 以 适当 推理 出 ， 所 有 测试 运 
行 的 速度 都 是 越 快 越 好 。 
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本 书 前 文 我 已 经 概括 了 TDD 测试 /编写 代码 循环 。 你 已 经 开始 习惯 TDD 流程 ， 时 而 编写 
最 少量 的 代码 ， 时 而 运行 测试 。 以 后 ， 一 分 钟 内 你 要 多 次 运行 单元 测试 ， 一 天 之 内 要 多 次 
运行 功能 测试 。 
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所 以 ， 简 单 而 言 ， 测 试 运行 的 时 间 越 长 ， 就 要 等 待 测试 运行 完毕 的 时 间 越 长 ， 因 此 也 就 拖 
慢 了 开发 进度 。 而 且 问题 还 不 止 于 此 。 





22.1.2 ” 神 赐 的 心 流 状态 


现在 从 社会 学 角度 分 析 。 我 们 程序 员 有 自己 的 文化 ， 有 自己 的 族群 信仰 。 这 个 族群 分 成 很 
多 群体 ， 例 如 崇拜 TDD 的 群体 (你 现在 已 经 成 为 其 中 一 员 )。 有 些 人 喜欢 vi， 还 有 些 人 离 
经 产道 ,喜欢 emacs。 但 我 们 都 认同 一 件 事 : 神 赐 的 心 流 状 态 一 一 这 是 一 种 精神 上 的 练习 ， 
我 们 自己 的 冥想 方式 。 我 们 的 精神 完全 专注 ， 几 个 小 时 弹指 一 挥 间 就 过 去 ， 代 码 自 然而 然 
地 从 指 间 疲 出 ， 问 题 虽 然 乏味 环 手 ， 但 难 不 倒 我 们 。 


























如 有 果 花 时 间 等 待 慢 吞 吞 的 测试 组 件 运行 完毕 ， 肯 定 无 法 进入 心 流 状态 。 只 要 超过 几 秒 钟 ， 
你 的 注意 力 就 会 分 散 ， 环 境 也 会 变化 ， 导 致 心 流 状态 消失 。 心 流 状态 就 像 梦 境 一 样 ， 只 要 
消失 ， 至 少 要 花 15 分 钟 才 能 重 现 。 





22.1.3 速度 慢 的 测试 经 常 不 想 运 行 ， i 

如 果 测 试 组 件 运行 得 慢 ， 你 会 失去 耐心 ， 不 想 运行 测试 ， 这 会 导致 问题 横行 。 我 们 也 许 会 
关于 重 构 代 码 ， 因 为 知道 重 构 后 要 花 很 多 时 间 等 ee 这 两 种 情况 都 会 导 
致 代码 变 坏 。 





22.1.4 现在 还 行 ， 不 过 随 着 时 间 推 移 ， 整 合 测试 会 变 得 越 
来 越 慢 


你 可 能 觉得 没事 ,测试 组 件 中 有 很 多 整合 测试 ， 超 过 50 个 ， 但 运行 只 用 了 0.2 秒 。 





可 是 要 知道 ， 这 个 应 用 很 简单 。 一 旦 应 用 变 得 复杂 ， 数 据 库 中 的 表 和 列 越 来 越 多 ， 整 合 测 
试 就 会 变 得 越 来 越 慢 。 在 两 个 测试 之 间 让 Django 重建 数据 库 所 用 的 时 间 会 越 来 越 长 。 


22.1.5 别 只 听 我 一 个 人 说 
Gary Bernhardt 的 测试 经 验 比 我 丰富 ， 他 在 演讲 “Fast Test, Slow Test” (https:/www.youtube. 
com/watch?v=RAxiiRPHS9k) 中 生动 地 阐述 了 这 些 观点 。 推 荐 你 看 一 下 演讲 视频 。 

















22.1.6 ”单元 测试 能 驱使 我 们 实现 好 的 设计 

但 是 ， 比 上 述 几 点 更 重要 的 好 处 或 许 我 在 第 19 章 已 经 说 过 。 为 了 编写 隔离 性 好 的 单元 测 
试 ， 必 须知 道 依 赖 下 一 层 中 的 什么 功能 ， 而 且 要 使 用 整合 测试 无 法 实现 的 解 耦 式 架 构 ， 这 
有 助 于 设计 出 更 好 的 代码 。 
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22.2 ”纯粹 的 单元 测试 有 什么 问题 
说 完 优点 我 们 要 来 个 大 转折 。 编 写 隔 离 的 单元 测试 也 有 其 危害 ， 尤 其 是 对 于 我 们 (包括 我 
和 你 ) 这 些 TDD 新 手 而 言 。 




















22.2.1 隔离 的 测试 难 读 也 难 写 

回忆 一 下 我 第 一 个 隔离 的 单元 测试 ， 是 不 是 很 丑 ?” 我 承认 ， 重 构 时 把 代码 移 到 表单 中 有 些 
改进 ， 但 想 一 下 如 果 疫 这 么 做 呢 ? 代码 基 中 就 会 有 一 个 十 分 难 读 的 测试 。 就 算是 这 个 测试 
的 最 终 版 本 ， 也 仍 有 一 些 比较 难 理解 的 部 分 。 





























22.2.2 ”隔离 测试 不 会 自动 测试 集成 情况 
稍 后 我 们 会 得 知 ， 隔 离 测试 只 测试 当前 关注 的 单元 ， 而 且 是 在 隔离 的 环境 中 测试 ， 这 种 测 
试 本 性 如 此 ， 不 测试 各 单元 之 间 的 集成 情况 。 








这 个 问题 众所周知 ， 也 有 很 多 缓解 的 方法 。 不 过 前 文 已 经 说 过 ， 这 些 缓解 措施 对 程序 员 来 
说 意味 着 要 付出 很 多 艰苦 努力 : 程序 员 要 记 住 各 单元 的 界面 ， 要 分 清 每 个 组 件 需 要 履行 的 
合约 ， 除 了 要 为 单元 的 内 部 功能 编写 测试 之 外 ， 还 得 为 合约 编写 测试 。 


























22.2.3 ”单元 测试 几乎 不 能 捕获 意料 之 外 的 问题 

单元 测试 能 帮助 你 捕获 差 一 错误 和 逻辑 混乱 导致 的 错误 ， 这 些 错误 在 编写 代码 时 经 常会 出 
纲 ， 我 们 知道 这 一 点 ， 所 以 这 些 错误 在 意料 之 中 。 不 过 出 现 预料 之 外 的 问题 时 ， 单 元 测试 
不 会 提醒 你 。 如 果 忘 记 创 建 数据 库 迁 移 ， 单 元 测试 不 会 提醒 你 ， 如 果 中 间 层 自作 聪明 转 义 
了 HTML 实体， 从 而 影响 数据 的 浑 染 方式 ， 显 示 成 “唐纳德 . 拉 姆 斯 菲尔德 的 XX” ， 单 元 
测试 也 不 会 提醒 你 。 


Im 


Na 

















22.2.4 ”使 用 驭 件 的 测试 可 能 和 实现 方式 联系 紧密 

最 后 还 有 个 问题 ， 使 用 驭 件 的 测试 可 能 和 实现 方式 之 间 过 度 炮 合 。 如 果 你 选择 使 用 List. 
objects.create() 创建 对 象 ， 但 是 驭 件 希 望 你 使 用 List() 和 .save()， 这 时 就 算 两 种 用 法 
的 实际 效果 一 样 ， 测 试 也 会 失败 。 如 果 不 小 心 ， 还 可 能 导致 测试 本 该 具有 的 一 个 好 处 缺 
失 ， 即 鼓励 重 构 。 如 果 想 修改 一 个 内 部 API， 你 会 发 现 自己 要 修改 很 多 使 用 驭 件 的 测试 和 
合约 测试 。 











注意 ， 处 理 你 无 法 控制 的 API 时 ， 这 可 能 不 单 是 一 个 问题 那么 简单 。 你 可 能 还 记得 我 们 如 
何 抛 弯 抹 角 地 测试 表单 : 创建 两 个 Django 模型 弘 件 ， 然 后 使 用 side_effect 检查 环境 的 状 
态 。 如 果 编 写 的 代码 完全 在 自己 的 控制 之 中 ， 你 可 能 想 设计 自己 的 内 部 API， 这 样 写 出 的 
代码 更 简洁 ， 而 且 测试 时 不 用 拐 这 么 多 弯 。 
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22.2.5 这些 问 题 都 可 以 解决 
但 是 ， 倡 导 编 写 隔 离 测试 的 人 会 过 来 告诉 你 ， 这 些 问 题 都 可 以 缓解 ， 你 要 熟练 编写 隔离 测 
试 ， 还 得 进入 神 赐 的 心 流 状态 。 


现在 我 们 论证 到 哪 一 步 了 ? 


22.3” 合 题 : 我 们 到 底 想 从 测试 中 得 到 什么 


退 一 步 想 一 下 ， 我 们 想 从 测试 中 得 到 什么 好 处 ， 为 什么 一 开始 要 编写 测试 ? 


22.3.1 正确 性 

希望 应 用 没有 问题 ， 不 管 是 差 一 错误 之 类 的 低层 逻辑 错误 ， 还 是 高 层 问 题 ， 例 如 软件 最 终 
应 该 提供 用 户 所 需 的 功能 。 想 知道 是 否 引 入 了 回归 ， 导 致 以 前 能 用 的 功能 失效 ， 而 且 想 在 
用 户 察觉 之 前 发 现 。 期 望 测试 告诉 我 们 应 用 可 以 正常 运行 。 





























22.3.2 简洁 可 维护 的 代码 

希望 代码 遵守 YAGNI 和 DRY 等 原则 。 和 希望 代码 清晰 地 表明 意图 ， 使 用 合理 的 方式 分 成 多 
个 组 件 ， 且 各 组 件 的 作用 明确 、 容 易 理解 。 期 望 从 测试 中 获取 自信 ， 可 以 放心 地 不 断 重 构 
应 用 ， 这 样 才 不 会 害怕 尝试 改进 设计 。 还 希望 测试 能 主动 帮 我 们 找到 正确 的 设计 。 






































22.3.3 高效 的 工作 流程 

最 后 ， 我 们 希望 测试 能 帮助 实现 一 种 快速 高 效 的 工作 流程 。 希 望 测试 有 助 于 减轻 开发 压 
力 ， 而 且 避 免 让 我 们 犯 一 些 愚 春 的 错误 。 希 望 测 试 能 让 我 们 始终 处 于 心 流 状 态 ， 因 为 心 流 
状态 不 仅 令 人 享受 ， 而 且 工 作 效 率 高 。 希 望 测 试 尽快 对 我 们 的 工作 做 出 反馈 ， 这 样 就 能 尝 
试 新 想法 ， 并 尽早 改进 。 而 且 ， 改 进 代 码 时 ， 如 果 测 试 不 能 提供 帮助 ， 我 们 也 不 想 让 它 成 
为 障碍 。 


22.3.4 根据 所 需 的 优势 评估 测试 
我 觉得 应 该 编写 多 少 测试 ， 以 及 功能 测试 、 整 合 测 试 和 隔离 测试 的 量 怎么 分 配 ， 没 有 通用 
的 规则 ， 因 为 每 个 项 目的 情况 不 同 。 但 可 以 把 所 有 测试 都 纳入 考虑 范围 ， 然 后 考量 各 种 测 
试 ， 看 它们 能 否 提供 你 需要 的 优势 ， 由 此 做 出 判断 。 
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目标 一 些 考量 事项 
正确 性 。 站 在 用 户 的 角度 看 ， 功 能 测试 的 数量 是 否 足够 保证 应 用 真 的 能 正常 运行 ? 

。 各 种 边界 情况 彻底 测试 了 吗 ? 感觉 这 是 低层 隔离 测试 的 任务 。 

。 有 没有 编写 测试 检查 所 有 组 件 之 间 是 否 能 正确 配合 ? 要 不 要 编写 一 些 整合 测试 ， 
或 者 只 用 功能 测试 就 行 ? 
简洁 可 维护 的 代码 ” 。 测试 有 没有 给 我 重 构 代 码 的 自信 ， 而 且 可 以 无 所 晨 惧 地 频繁 重 构 ? 
。 测试 有 没有 帮 有 我 得 到 一 个 好 的 设计 ? 如 果 整 合 测试 较 多 ， 隔 离 测试 较 少 ， 我 要 投 
入 精力 为 应 用 的 哪 一 部 分 编写 更 多 隔离 测试 ， 才 能 得 到 关于 设计 更 全 面 的 反馈 ? 
反馈 循环 的 速度 令 我 满意 吗 ?我 什么 时 候 能 得 到 问题 的 提醒 ， 有 没有 某 种 方法 可 
以 让 提醒 更 早出 现 ? 
。 如 果 高 层 功 能 测试 很 多 ， 运 行 时 间 很 长 ， 要 花 整 晚 时 间 才 能 得 到 意外 回归 的 反 
馈 ， 有 没有 一 种 方法 可 以 让 我 编写 速度 更 快 的 测试 ， 整 合 测试 也 行 ， 让 我 早点 儿 
得 到 反馈 ? 
如 果 需 要 ， 我 能 否 运行 整个 测试 组 件 的 一 个 子 集 ? 
。 我 是 否 花 了 太 多 时 间 等 待 测试 运行 完毕 ， 导 致 高 效率 的 心 流 状态 时 间 缩短 ? 


22.4 架构 方案 
还 有 一 些 架构 方案 可 以 帮助 测试 组 件 发 挥 最 大 的 作用 ， 而 且 特别 有 助 于 避免 隔离 测试 的 
缺点 。 


这 些 架构 方案 大 都 要 求 找到 系统 的 边缘 ， 即 代码 和 外 部 系统 〈 例 如 数据 库 、 文 件 系统 、 万 
维 网 或 者 UI) 交互 的 地 方 ， 然 后 尝试 将 外 部 系统 和 应 用 的 核心 业务 逻辑 区 分 开 。 
























































高 效 的 工作 流程 





























22.4.1 ”端口 和 适配器 (或 六 边 形 、 简 洁 ) 架构 

集成 测试 在 系统 的 边界 ， 也 就 是 代码 和 外 部 系统 (例如 数据 库 、 文 件 系统 或 UI 组 件 
成 的 地 方 ， 作 用 最 大 。 

所 以 ， 也 就 是 在 边界 ， 隔 离 测 试 和 驭 件 的 作用 最 小 ， 因 为 在 边界 如 果 测 试 和 某 种 实现 方式 
耦合 过 于 紧密 ， 最 有 可 能 干扰 你 ， 或 者 在 边界 需要 进一步 确认 各 组 件 之 间 是 否 正 确 集成 。 


相反 ， 应 用 的 核心 代码 (只 关注 业务 逻辑 和 业务 规则 的 代码 ， 完 全 在 我 们 控制 之 中 的 代 
码 ) 不 太 需 要 整合 测试 ， 因 为 我 们 能 控制 也 能 理解 这 些 代码 。 





— 


集 



































所 以 ， 实 现 需求 的 一 种 方法 是 尽量 减少 处 理 边界 的 代码 量 。 这 样 ， 就 可 以 使 用 隔离 测试 检 
查核 心 业务 逻辑 ， 使 用 整合 测试 检查 集成 点 。 

















Steve Freeman 和 Nat Pryce 在 他 们 合 著 的 书 Growing Object-Oriented Sofiware 中 把 这 种 方案 
称 为 “端口 和 适配器 ”( 如 图 22-1)。 

















其 实 ， 第 19 章 已 经 朝 端口 和 适配器 架构 方案 努力 了 ， 当 时 我 们 发 现 编写 隔离 的 单元 测试 
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要 把 ORM 代码 从 主 应 用 中 移 除 ， 定 义 为 模型 层 的 辅助 函数 。 

















22-1: 端口 和 适配器 (Nat Pryce 绘制 ) 


这 种 模式 有 时 也 叫 “ 简 洁 架 构 ” 或 “六 边 形 架 构 "。 详 情 参 见 本 章 末尾 的 扩展 阅读 部 分 。 


22.4.2 ”函数 式 核心 ， 命 令 式 外 壳 
Gary Bernhardt 更 进一步 ， 推 荐 使 月 





他 称 为 “函数 式 核心 ， 命 令 式 外 充 ” 的 架构 。 应 用 的 
“外 碗 ”是 边界 交互 的 地 方 ， 遵 守 命 令 式 编程 范式 ， 可 以 使 用 整合 测试 、 验 收 调试 检查 ， 
如 果 精 简 到 一 定 程度 ， 甚 至 完全 不 用 测试 。 而 应 用 的 核心 使 用 函数 式 编 程 范式 编写 〈 完 全 
没有 副作用 ) ， 因 此 可 以 使 用 完全 隔离 、 纯 粹 的 单元 测试 ， 根 本 无 需 使 用 驭 人 























这 个 方案 的 详细 说 明 ， 参 见 Gary 的 演讲 ， 题 为 Boundaries (https://www.youtube.com/ 
watch?v=eOYal8elnZk) 。 


22.5 小结 


尝试 概述 了 TDD 流程 涉及 的 深层 次 注意 事项 。 经 过 长 年 的 实践 经 验 积累 才能 领悟 这 些 


观点 ， 所 以 我 非常 没 资格 讨论 这 些 事 情 。 我 衷心 鼓励 你 怀疑 我 所 说 的 一 切 ， 摆 脱 这 些 
的 束缚 ， 找 到 适合 自己 的 方式 。 最 重要 的 一 点 是 ， 要 征求 真正 专家 的 意见 。 





广 
观点 
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二 








下 列 出 了 一 些 扩展 阅读 资料 。 











扩展 阅读 
Fast Test、 Slow Test 和 Boundaries 
Gary Bernhardt 分 别 于 2012 年 (https:Wwww.youtube.com/watch?v=RAxiiRPHS9k) 
和 2013 年 (https://www.youtube.com/watch?v=eOYal8elnZk) 在 Pycon 中 所 做 的 演 
讲 。 他 制作 的 视频 (https://www.destroyallsoftware.com) 也 值得 一 看 。 


总 口 和 送 配 器 

Steve Freeman 和 Nat Pryce 在 他 们 合 著 的 书 中 提出 这 种 架构 。 这 个 演讲 (http://vimeo. 
com/83960706) 对 此 也 做 了 很 好 的 讨论 。 还 可 以 阅读 Uncle Bob 对 简洁 架构 的 说 明 
(http://blog.8thlight.com/uncle-bob/2012/08/13/the-clean-architecture.html) ， 以 及 Alistair 
Cockburn 提出 六 边 形 架构 的 文章 (http:Walistair.cockburn.usHexagonal+architecture ) 。 


炽热 的 岩 桨 
Casey Kinsey 提醒 ， 尽 量 避 免 和 数据 库 交 互 (https://www.youtube.com/watch?v=bsm 
FVb8guMU), 


翻转 金字 塔 
如 果 项 目 中 运行 速度 慢 的 高 层 测 试 和 单元 测试 的 比值 太 大 ， 可 以 使 用 这 种 形象 的 比 
喻 努力 翻转 比值 (http://watirmelon.com/tag/testing-pyramid/) 。 


整合 测试 是 个 骗局 

J.B. Rainsberger 写 过 一 篇 著名 的 文章 (http://blog.thecodewhisperer.com/2010/10/16/ 
integrated-tests-are-a-scam/) ， 痛 斤 整 合 测试 ， 声 称 它 会 贷 了 你 的 生活 。 演 讲 视频 可 
以 在 两 个 网 站 中 观看 ， 地 址 分 别 为 http://www.infoq.com/presentations/integration- 
tests-scam 和 http://vimeo.com/80533536， 不 过 录制 效果 都 不 好 。 还 可 以 阅读 几 篇 后 
续 文 章 ， 尤 其 是 这 篇 防范 验收 测试 (我 叫 它 功能 测试 ) 的 文章 (http://www.jbrains. 
ca/permalink/using-integration-tests-mindfully-a-case-study)， 以 及 这 篇 分 析 速 度 慢 
的 测试 是 如 何 扼杀 效率 的 文章 (http://www.jbrains.ca/permalink/part-2-some-hidden- 
costs-of-integration-tests ) 。 


务实 的 角度 


Martin Fowler (《 重 构 》 的 作者 ) 提出 一 种 合理 平衡 的 务实 方案 (http://martinfowler. 
com/bliki/UnitTest.htm!l) 。 
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遵从 测试 山羊 的 教诲 


回 过 头 再 看 测试 山羊 。 


你 可 能 会 说 :“ 唉 ， 哈 利 ， 大 概 17 章 之 前 ， 测 试 山 羊 就 没 那 么 有 趣 了 。 请 容许 我 路 劝 几 
句 ， 我 要 用 测试 山羊 表达 一 些 重要 的 观点 。 


Nn 

测试 很 难 
当 我 看 到 “遵从 测试 山羊 的 教诲 ”这 和 句 话 时 ， 第 一 印象 是 它 道 出 了 一 个 事实 : 测试 很 
难 不 是 说 测试 本 身 难 ， 而 是 难 在 坚持 ， 一 直 做 下 去 。 


走 捷径 少 写 儿 个 测试 感觉 更 容易 。 而 且 心 理 上 更 难 接受 测试 ， 因 为 付出 的 努力 和 得 到 的 回 
报 太 不 成 正比 。 现 在 花 时 间 编 写 的 测试 不 会 立即 显 出 功效 ， 要 等 到 很 久 以 后 才 有 作用 一 一 
或 许 几 个 月 之 后 避免 在 重 构 过 程 中 引入 问题 ,或 者 升级 依赖 时 捕获 回归 。 或 许 济 试 会 以 一 
种 很 难 衡量 的 方式 回报 你 ， 促 使 你 写 出 设计 更 好 的 代码 ， 但 你 却 认为 就 算 没 有 测试 也 能 写 
出 如 此 优雅 的 代码 。 


为 本 书 编写 测试 框架 时 ， 我 自己 也 开始 犯 这 种 错误 了 。 书 中 的 代码 很 复杂 ， 所 以 本 身 也 有 
测试 ， 但 我 偷懒 了 ， 测 试 得 羡 度 并 不 理想 ， 现 在 我 后 悔 了 ， 因 为 测试 写 得 年 拙 又 了 陋 (有 
一 天 我 会 开源 这 个 测试 框架 ， 那 时 你 就 可 以 指责 我 、 喇 笑 我 了 )。 

让 CI 构建 始终 能 通过 


需要 真正 付出 心力 的 另 一 个 领域 是 持续 集成 。 读 过 第 20 章 我 们 知道 ，CI 构建 有 时 会 出 现 
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意料 之 外 的 奇怪 问题 。 出 现 这 种 问题 时 ， 如 果 觉 得 在 自己 的 设备 中 正常 就 行 ， 很 容易 放任 
不 管 。 但 是 ， 如 果 不 小 心 ， 你 会 开始 容忍 CI 中 有 失败 的 测试 组 件 ， 入 而 久之 ，CI 构建 便 失 
去 了 意义 。 若 想 再 次 让 CI 构建 运行 起 来 ， 工 作 量 更 大 。 千 万 别 落 入 这 个 圈套 。 只 要 坚持 ， 
终究 会 找到 测试 失败 的 原因 ， 而 且 能 找到 解决 的 方法 ， 再 次 让 构建 通过 ， 发 挥 决断 作用 。 


像 重 视 代码 一 样 重视 测试 
别 再 把 测试 看 成 真正 的 代码 的 陪衬 ， 把 它 当 做 你 在 开发 的 产品 的 一 部 分 ， 精 心 雕 级 ， 注 重 
美观 ， 就 算 发 布 出 去 也 不 会 闭 于 面 对 众 人 检视 。 这 么 想 有 助 于 你 接受 测试 。 


做 测试 的 原因 有 很 多 : 可 能 是 测试 山羊 告诉 你 要 做 ， 可 能 是 你 知道 就 算 不 能 立即 得 到 回 
报 ， 但 终究 会 得 到 ， 可 能 是 出 于 责任 感 、 职 业 素养 ， 或 强迫 症 ， 或 者 想 挑战 自己 ;还 可 能 
是 因为 测试 值得 实践 。 但 终极 原因 是 ， 测 试 让 软件 开发 变 得 更 有 乐趣 。 


别 筷 了 给 吧台 服务 员 小 费 


没有 O’Reilly Media 出 版 社 的 支持 ， 我 不 可 能 写成 这 本 书 。 如 果 你 看 的 是 在 线 免 费 版 ， 希 
望 你 能 考虑 买 一 本 (http:Wwww.jdoqocy.comy/click-7347114-11724864) 。 如 果 你 自己 不 需要 ， 
或 许可 以 作为 礼物 送 给 朋友 。 


别 见 外 
希望 你 喜欢 这 本 书 。 请 一 定 要 和 我 联系 ， 告 诉 我 你 的 想法 1 
哈 







































































。 @hjwp 








384 | 遵从 测试 山羊 的 教诲 


附录 人 A 
PythonAnywhere 

















阅读 本 书 时 ， 你 是 否 计划 使 用 PythonAnywhere ? 下 面 给 出 一 些 说 明 ， 告 诉 你 如 何 使 用 某 
些 功能 ， 尤 其 是 Selenium/Firefox 测试 、 运 行 测试 服务 器 以 及 截图 。 


如 果 你 还 没有 PythonAnywhere 的 账户 ， 先 要 注册 一 个 ， 免 费 的 就 行 。 





A.1 使 用 Xvfb 在 Firefox 中 运行 Selenium 会 话 


还 有 一 件 事 ，PythonAnywhere 是 只 有 终端 的 环境 ， 所 以 没有 显示 器 就 无 法 打开 Firefox。 
但 我 们 可 以 使 用 虚拟 显示 器 。 





读 第 1 章 编 写 第 一 个 测试 时 ， 你 会 发 现 无 法 正常 运行 。 第 一 个 测试 如 下 所 示 ， 可 以 在 
PythonAnywhere 提供 的 编辑 器 中 输入 : 





from selenium import webdriver 
browser = webdriver.Firefox() 
browser .get('http://Llocalhost:8000') 
assert 'Django' in browser.title 


但 (在 Bash 终端 ) 运行 时 会 看 到 如 下 错误 : 


$ python3 functional_tests.py 

Traceback (most recent call last): 

File "tests.py", line 3, in <moduLe> 

browser = webdriver.Firefox() 

File "/usr/local/lib/python3.3/site-packages/selenium/webdriver/firefox/webdrive 
self.binary, timeout), 

File "/usr/local/lib/python3.3/site-packages/selenium/webdriver/firefox/extensio 
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self.binary.launch_browser(self.profile) 

File "/usr/local/lib/python3.3/site-packages/selenium/webdriver/firefox/firefox_ 
self. wait_until_connectable() 

File "/usr/local/lib/python3.3/site-packages/selenium/webdriver/firefox/firefox_ 
self. get firefox_output()) 

selenium.common.exceptions.WebDriverException: Message: 'The browser appears to 
have exited before we could connect. The output was: Error: no display 
specifiedNn' 


解决 方法 是 使 用 Xvfb (X Virtual Framebuffer 的 简称 )。 在 没有 真正 的 显示 器 的 服务 器 中 ， 
Xvfb 会 启动 一 个 虚拟 显示 器 ， 供 Firefox 使 用 。 


如 果 没 看 到 上 述 错 误 ， 而 是 "ImportError，no module named selenium"， 解 
决 的 方法 是 执行 ptp3 install --user seleniun 命令 。 


xvfb-run 命令 的 作用 是 ， 在 Xvfb 中 执行 下 一 个 命令 。 使 用 这 个 命令 就 会 看 到 预期 失败 : 


$ xvfb-run python3 functional_tests.py 
Traceback (most recent call last): 
File "tests.py", line 11, in <module> 
assert 'Django' in browser.title 
AssertionError 


A.2 ”以 PythonAnywhere Web 应 用 的 方式 安装 Django 


之 后 就 要 安装 Django。 我 不 建议 使 用 django-admin.py start project 命令 ,推荐 使 用 
PythonAnywhere“Web” 选 项 卡 中 的 快速 设置 。 添 加 一 个 新 Web 应 用 ， 选 择 Django 和 
Python 3， 然 后 在 项 目 名 中 填写 superlists。 











而 且 ， 不 要 在 终端 里 运行 测试 服务 器 ， 让 它 运 行 在 地 址 Locathost:86006 上 ， 可 以 使 用 
PythonAnywhere Web 应 用 提供 的 真实 地 址 : 


browser .get('http://my-username.pythonanywhere.com') 


每 次 修改 代码 后 都 要 点 击 “Reload Web App”( 重 新 加 载 Web 应 用 ) 按钮 ， 
更 新 网 站 。 





音效 果 更 好 | 


放 














主 1: 也 可 以 在 终端 里 运行 开发 服务 器 ,但 有 个 问题 ， PythonAnywhere 的 终端 不 一 定 运 行 在 同一 台 服 务 器 中 ， 
所 以 无 法 保证 运行 测试 的 终端 和 运行 服务 器 的 终端 是 同一 个 。 而 且 ， 如 果 在 终端 里 运行 服务 器 ,没有 
简单 的 方法 视觉 检查 网 站 的 外 观 。 
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A.3 清理 /tmp 目 录 


Selenium 和 Xvfb 会 在 /tmp 目录 中 留 下 很 多 垃圾 ， 如 果 关 闭 的 方式 不 优雅 ， 情 况 更 糟 (所 
以 前 文才 要 使 用 try/finally 语句 )。 


遗留 的 东西 太 多 ， 可 能 会 用 完 存储 配额 。 所 以 要 经 常 清 理 /tmp 目录 : 


$ rm -rf /tmp/* 


A.4 截图 

在 第 5 章 中 ， 我 建议 使 用 time.steep 在 功能 测试 运行 的 过 程 中 暂停 一 会 儿 ， 这 样 才能 在 屏 
幕 上 看 到 Selenium 浏览 器 。 在 PythonAnywhere 做 不 到 这 一 点 ， 因 为 浏览 器 运行 在 虚拟 显 
示 器 中 。 不 过 你 可 以 检查 线 上 网 站 ,或 者 别管 应 该 看 到 什么 ， 相 信 我 说 的 就 行 了 。 

对 运行 在 虚拟 显示 器 中 的 测试 做 视觉 检查 ， 最 好 的 方法 是 使 用 截图 。 如 果 你 想 知道 怎么 
做 ， 看 一 下 第 20 章 ， 那 里 有 一 些 示例 代码 。 


A.5 关于 部 署 


读 到 第 8 章 时 ， 你 可 以 选择 继续 使 用 PythonAnywhere， 也 可 以 选择 学 习 如 何 配置 真实 的 服 
务 器 。 我 建议 选择 后 者 ， 因 为 这 样 学 到 的 更 多 。 


如 果 想 一 直 使 用 PythonAnywhere， 可 以 把 应 用 部 署 到 其 他 域名 下 。 你 需要 一 个 自己 的 域名 
和 一 个 PythonAnywhere 付费 账户 。 就 算 不 这 么 做 ， 也 得 确保 功能 测试 能 在 真实 的 过 渡 网 
站 中 运行 ， 而 不 能 使 用 LiveserverTestCase 提供 的 多 线程 服务 器 。 






































如 果 阅 读本 书 时 你 从 头 至 尾 都 使 用 PythonAnywhere， 我 很 想 听 听 你 是 怎么 做 
到 的 。 请 给 我 发 电子 邮件 ， 地 址 是 obeythetestinggoat@gmail.com。 
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附录 日 


基于 类 的 Django 视 图 





本 附录 接续 第 12 章 。 第 12 章 实现 了 Django 表单 的 验证 功能 ， 还 重 构 了 视图 。 结 束 时 ， 
视图 仍然 使 用 函数 实现 。 

















不 过 ，Django 领域 现在 流行 使 用 基于 类 的 视图 (Class-Based View，CBV)。 在 这 个 附录 
中 ， 我 们 要 重 构 应 用 ， 把 视图 函数 改写 成 基于 类 的 视图 。 更 确切 地 说 ， 我 们 要 党 试 使 用 基 
于 类 的 通用 视图 (Class-Based Generic View，CBGV )。 


B.1 基于 类 的 通用 视图 

基于 类 的 视图 和 基于 类 的 通用 视图 有 个 区 别 。 基 于 类 的 视图 只 是 定义 视图 函数 的 男 一 种 方 
式 ， 对 视图 要 做 的 事情 没有 太 多 假设 ， 和 视图 函数 相 比 主要 的 优势 是 可 以 创建 子 类 。 不 过 
也 要 付出 一 定 代 价 ， 基 于 类 的 视图 比 传统 的 基于 国 数 的 视图 可 读 性 差 (这 一 点 有 和 争论 )。 
普通 的 CBV 的 作用 是 让 多 个 视图 重用 相同 的 逻辑 ， 因 为 我 们 想 遵 守 DRY 原则 。 如 果 使 用 
基于 函数 的 视图 ， 重 用 逻辑 要 使 用 辅助 函数 或 修饰 器 。 理 论 上 ,使 用 类 实现 更 优雅 。 















































































































































基于 类 的 通用 视图 也 是 一 种 基于 类 的 视图 ， 但 它 尝 试 为 常见 操作 提供 现成 的 解决 方案 ， 例 
如 从 数据 库 中 获取 对 象 后 传 入 模板 ,获取 一 组 对 和 象 ， 使 用 ModelForm 保存 POST 请 求 中 用 户 
输入 的 数据 ， 等 等 。 看 起 来 现在 需要 的 就 是 这 种 视图 ， 不 过 稍 后 就 会 发 现 魔鬼 藏 在 细节 中 。 
































这 里 我 想 说 ， 我 并 不 常用 任何 一 种 基于 类 的 视图 。 我 完全 能 看 到 这 种 视图 的 合理 之 处 ， 而 且 
在 Django 应 用 中 有 很 多 地 方 都 非常 适合 使 用 CBGV。 但 是 ， 只 要 需求 稍微 高 一 点 儿 ， 例 如 
想 使 用 多 个 模型 ， 就 会 发 现 基于 类 的 视图 比 传统 的 视图 函数 难 读 得 多 (这 一 点 也 有 和 争论 )。 
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不 过 
种 视 
我 希 
么 做 


， 因 为 必须 使 用 基于 类 的 视图 提供 的 几 个 定制 选项 ， 通 过 这 种 实现 方式 能 学 到 很 多 这 
图 的 工作 方式 ， 以 及 如 何 为 这 种 视图 编写 单元 测试 。 


望 为 基于 函数 的 视图 编写 的 单元 测试 也 能 正常 测试 基于 类 的 视图 。 看 一 下 具体 该 怎 


o 



































B.2 使 用 FormView 实 现 首页 


网 站 


看 过 


的 首页 只 是 在 模板 中 显示 一 个 表单 : 





def home_page(request): 
return render(request, 'home.html', {'form': ItemForm()}) 


可 选 视图 (https://docs.djangoproject.com/en/1.6/ref/class-based-views/) 之 后 ， 我 们 发 现 











Django 提供 了 一 个 通用 视图 ， 叫 FormView。 看 一 下 怎么 用 : 


指定 
行 代 


,J 


直人 


目前 


现在 











lists/views.py (ch311001) 


from django.views.generic import FormView 


[a 


class HomePageView(FormView) : 
template_name = "home.htmlL' 
form_class = ItemForm 





想 使 用 哪个 模板 和 表单 。 然 后 ， 只 需 更 新 urls.py， 把 含有 lists.views.home_page 那 
码 改 成 : 


superlists/urls.py (ch311002) 


url(r'^$', HomePpageView.as_view(), name='home'), 
所 有 测试 确认 ， 这 很 简单 : 

$ python3 manage.py test lists 

La] 

Ran 34 tests in 0.119s 

OK 


$ python3 manage.py test functionaL_tests 


[...] 


Ran 4 tests in 15.160s 
OK 








为 止 一 切 顺利 。 把 一 行 代码 的 视图 函数 换 成 有 两 行 代码 的 类 ， 而 且 可 读 性 依然 不 错 。 
是 提交 的 好 时 机 。 
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B. 


3 使 用 form_vaLid 定 制 CreateView 





下 国 














i 改写 新 建 请 单 的 视图 ， 也 就 是 new_List 函数 。 现 在 这 个 视图 如 下 所 示 : 





lists/views.py 


def new_list(request): 

form = ItemForm(data=request.POST) 

if form.is_valid(): 
list = List.objects.create() 
form.save(for_list=list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', {"form": form}) 





浏览 可 用 的 CBGYV 列表 之 后 ， 发 现 需要 的 或 许 是 CreateView， 而 且 知 道 要 使 用 ItemForm 


类 ， 





下 面 看 一 下 具体 该 怎么 做 ， 以 及 测试 能 否 提 供 帮 助 : 











lists/views.py (ch311003) 


from django.views.generic import FormView, CreateView 


[...] 


class NewListView(CreateView): 
form_class = ItemForm 


def new_list(request): 


[ee 


我 要 在 views.py 中 保留 原来 的 视图 函数 ， 这 样 才能 从 中 复制 代码 ， 等 一 切 都 能 正常 运行 之 
后 再 删除 。 这 么 做 没什么 危害 ， 只 要 修改 URL 映射 就 行 。 这 一 次 要 这 么 改 : 








lists/urls.py (ch311004) 


from django.conf.urls import patterns, url 
from lists.views import NewListView 


urlpatterns = patterns('', 
url(r'^(\d+)/$', 'lists.views.view list', name='view_list'), 
url(r'^new$', NewListView.as_view(), name='new_list'), 


) 


然后 运行 测试 。 有 6 个 错误 : 


$ python3 manage.py test lists 


ERROR: test for_invalid input_passes_form to_template 

(lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 
'get_template_names()' 


ERROR: test for_invalid input_renders home template (lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
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either a definition of "tempLate_name' or an implementation of 
'get_template_names()' 


ERROR: test invalid list items arent_saved (lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 
'get_template_names()' 


ERROR: test_redirects after_POST (lists.tests.test views.NewListTest) 
TypeError: save() missing 1 required positional argument: 'for_list' 


ERROR: test_ saving a_POST_request (lists.tests.test views.NewListTest) 
TypeError: save() missing 1 required positional argument: 'for_list' 


ERROR: test validation errors_are_shown_on_home page (lists.tests.test views. 
NewListTest) 


django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 
'get_template_names()' 


Ran 34 tests in 0.125s 


FAILED (errors=6) 





先 解决 前 3 个 一 一 设 定 模 板 应 该 就 可 以 了 吧 ? 


lists/views.py (ch311005) 
class NewListView(CreateView): 
form_class = ItemForm 
template_name = 'home.html' 


现在 只 剩 两 个 错误 了 ， 可 以 看 出 ， 这 两 个 错误 都 发 生 在 通用 视图 的 form_valid 方法 中 。 这 
个 方法 可 以 重新 定义 来 定制 CBGYV 的 行为 。 从 这 个 方法 的 名 字 可 以 看 出 ， 视 图 认为 表单 中 
的 数据 有 效 之 后 才 会 运行 这 个 方法 。 可 以 从 以 前 的 视图 函数 中 把 if form.is_valid(): 之 
后 的 代码 复制 过 来 : 


























lists/views.py (ch311005) 


class NewListView(CreateView): 
template_name = "home.htmlL' 
form_class = ItemForm 


def form valid(self, form): 
list = List.objects.create() 
form.save(for_list=list ) 
return redirect(list ) 


这 样 测 试 就 能 全 部 通过 了 : 





$ python3 manage.py test lists 
Ran 34 tests in 0.119s 
OK 
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$ python3 manage.py test functional_tests 
Ran 4 tests in 15.157s 
OK 


而 且 ， 为 了 遵守 DRY 原则 ， 可 以 使 用 CBV 的 主要 优势 之 一 一 一 继承 ， 市 省 两 行 代码 : 


lists/views.py (ch311007) 
class NewListView(CreateView, HomePageView): 
def form valid(self, form): 
list = List.objects.create() 


Item.objects.create( text=form.cleaned data[ 'text'], list=list) 
return redirect('/lists/%d/' % (list.id,)) 


测试 应 该 仍 能 全 部 通过 : 


OK 





其 实在 面向 对 象 编程 中 这 么 做 并 不 好 。 继 承 意味 着 “是 一 个 什么 ”这 种 关 
系 ， 但 是 说 新 建 清单 视图 “是 一 个 ”首页 视图 或 许 没 有 什么 意义 。 所 以 ,或 
许 最 好 别 这 么 做 。 
































不 管 做 没 做 最 后 一 步 ， 你 觉得 和 以 前 的 版 本 相 比 怎么 样 ? 我 觉得 还 不 错 。 不 用 写 样板 代码 
了 ， 而 且 视 图 代码 还 相当 易 读 。 目 前 ，CBGYV 得 了 一 分 ， 和 基于 函数 的 视图 平局 。 


B.4 一 个 更 复杂 的 视图 ， 既 能 查看 清单 ， 也 能 后 
清单 中 添加 待 办 事项 


我 做 了 好 多 尝试 才 写 出 这 个 视图 。 不 得 不 说 ,虽然 测 试 能 告诉 我 做 得 对 不 对 ， 但 是 在 寻 
找 实 现 步 又 的 过 程 中 并 没 给 出 实质 帮助 ， 大 多 数 情 况 下 我 都 在 反复 实验 ， 党 试 使 用 get_ 
context_data 和 get_form_kwargs 等 国 数 。 








不 过 ， 在 实现 的 过 程 中 我 意识 到 一 件 事 : 编写 多 个 只 测试 一 件 事 的 测试 很 重要 。 所 以 又 回 
头 重 写 了 第 10-12 章 的 部 分 内 容 。 


B.4.1 测试 有 指引 作用 ， 但 时 间 不 长 
下 面 是 一 种 实现 方式 。 首 先 ， 我 觉得 需要 使 用 petattview， 显 示 对 象 的 详情 ; 























lists/views.py 


from django.views.generic import FormView, CreateView, DetailView 


[...] 
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class ViewAndAddToList(DetailView): 
model = List 


测试 的 结果 为 : 
[...] 


AttributeError: Generic detail view ViewAndAddToList must be called with either 
an object pk or a slug. 
FAILED (failures=5, errors=6) 





失败 消息 的 意思 并 不 明确 ， 在 谷歌 中 搜索 一 番 之 后 我 才 知 道 要 使 用 正则 表达 式 具 名 捕获 组 : 


lists/urls.py (ch311011) 


@@ -1,7 +1,7 @@ 
from django.conf.urls import patterns, url 
-from lists.views import NewListView 
+from lists.views import NewListView, ViewAndAddToList 


urlpatterns = patterns('', 
- url(r'^(\d+)/$', 'lists.views.view list', name='view list'), 
+ url(r'^(?P<pk>\d+)/$', ViewAndAddToList.as_view(), name='view_ list'), 
url(r'^new$', NewListView.as_ view(), name='new_list'), 


) 
现在 测试 中 出 现 的 错误 就 相当 有 帮助 了 : 











i 


django. template.base.TemplateDoesNotExist: lists/list detail.html 


FAILED (failures=5, errors=6) 


lists/views.py 


class ViewAndAddToList(DetailView): 
model = List 
tempLate_name = "List.htmlL' 





这 次 改动 后 ， 只 剩 两 个 错误 了 : 
| 
ERROR: test displays_item form (lists.tests.test views.ListViewTest) 


KeyError: 'form' 


FAILED (failures=5, errors=2) 


B.4.2 ”现在 不 得 不 反复 实验 
我 发 现 这 个 视图 不 仅 要 显示 对 象 的 详情 ， 还 要 能 新 建 对 象 。 所 以 这 个 视图 要 继承 DetailView 
和 CreateView 
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lists/views.py 


class ViewAndAddToList(DetailView, CreateView): 
model = List 
template name = 'list.html’ 
form class = ExistingListItemForm 


但 是 这 么 改 ， 得 到 了 很 多 错误 : 


Ce] 


TypeError: _ init () missing 1 required positional argument: 'for_list' 


而 且 那 个 KeyError: 'form' 错误 还 在 。 





现在 ,错误 消息 没什么 用 了 ， 而 且 下 一 步 该 做 什么 也 不 明确 。 我 不 得 不 反复 实验 。 不 过 ， 
测试 仍 能 告诉 我 做 得 对 还 是 把 情况 变 得 更 精 。 





首先 尝试 使 用 get_form_kwargs， 但 没什么 用 ， 不 过 我 发 现 可 以 使 用 get_form: 


lists/views.py 


def get form(self, form class): 
self.object = self.get object() 
return form class(for_list=self.object, data=self.request.POST) 








但 必须 给 self.object 赋值 才能 使 用 get_form， 对 此 我 一 直 心 里 不 安 。 不 过 现在 只 剩 3 个 
错误 了 ， 显 然 是 因为 表单 还 没 传人 模板 。 














KeyError: 'form' 


FAILED (errors=3) 


B.4.3 测试 再 次 发 挥 作 用 
又 做 了 几 次 实验 之 后 ， 我 把 petattView 换 成 了 SingteobjectMtxtn (文档 中 有 些 线索 ) : 


from django.views.generic.detail import SingleObjectMixin 


[i] 


class ViewAndAddToList(CreateView, SingleObjectMixin): 
[zd 


这 么 修改 之 后 ， 只 剩 两 个 错误 了 : 


django.core.exceptions.ImproperlyConfigured: No URL to redirect to. Either 
provide a url or define a get absolute url method on the Model. 


对 最 后 的 这 两 个 失败 ， 测 试 又 变 有 用 了 。 解 决 的 方法 很 简单 ， 在 Iten 类 中 定义 get_absolute_url 
方法 ， 让 待 办 事项 指向 所 属 的 清单 页 面 即 可 : 
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lists/models.py 
class Item(models.Model): 


Ess] 


def get absolute url(self): 
return reverse('view list', args=[self.list.id]) 


B.4.4 这 是 最 终结 果 吗 
最 终 写 出 的 视图 类 如 下 所 示 : 





lists/views.py (ch311010) 


class ViewAndAddToList(CreateView, SingleObjectMixin): 
tempLate_name = "List.htmlL' 
modeL = List 
form_cLass = ExistingListItemForm 


def get form(self, form class): 


self.object = self.get object() 
return form class(for_list=self.object, data=self.request.POST) 


B.5 新 旧版 对 比 


比较 一 下 旧版 和 新 版 : 





lists/views.py 


def view list(request, list id): 
list = List.objects.get(id=list id) 
form = ExistingListItemForm(for_list=list ) 
if request.method == 'POST': 
form = ExistingListItemForm(for_list=list_ , data=request.POST) 
if form.is_valid(): 
form.save() 
return redirect(list ) 
return render(request, 'list.html', {'list': list , "form": form}) 


虽然 新 版 代码 缩减 到 7 行 ， 但 我 还 是 觉得 基于 函数 的 视图 稍微 容易 理解 一 点 儿 ， 因 为 旧 
版 没 隐 蕊 那么 多 细 市 ， 和 毕竟 “明确 表述 比 含糊 其 辞 强 *”， 这 是 Python 的 禅 理 。 我 的 意思 
是 ， 谁 知道 Single0bjectMixin 是 什么 呢 ?” 而 且 更 讨厌 的 是 ， 如 果 在 get_forn 方法 中 不 给 
self.object 赋值 ， 整 个 类 都 不 能 用 。 这 一 点 太 烦 人 。 
































不 过 ， 我 猜 有 些 人 喜欢 这 种 实现 方式 。 


B.6 为 CBGV 编 写 单元 测试 有 最 佳 实践 吗 


实现 这 个 视图 类 之 后 ， 我 发 现 有 些 单元 测试 有 点 儿 太 关注 高 层 。 这 并 不 意外 ， 
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Django 测试 客户 端的 视图 测试 或 许 更 应 该 叫 整合 测试 。 
测试 会 告诉 我 做 得 对 不 对 ， 但 不 能 始终 提示 具体 应 该 怎么 修正 错误 。 
有 时 ， 我 想 知 道 有 没有 一 种 编写 测试 的 方法 ， 更 贴近 实现 方式 ， 例 如 这 么 编写 测试 : 








def test cbv_gets correct object(self): 
our_list = List.objects.create() 
view = ViewAndAddToList() 
view.kwargs = dict(pk=our_list.id) 
self.assertEqual(view.get object(), our_list) 
但 这 么 做 有 个 问题 ， 必 须 对 Django CBV 的 内 部 机 理 有 一 定 了 解 ， 才 能 正确 设 定 这 种 测试 。 
而 且 最 后 还 是 会 被 复杂 的 继承 体系 弄 得 十 分 糊涂 。 


记 住 : 编写 多 个 只 有 一 个 断言 的 隔离 视图 测试 有 所 帮助 
在 这 个 附录 中 我 得 出 一 个 结论 ， 编写 多 个 简短 的 单元 测试 比 编写 少量 含有 很 多 断言 的 测试 
有 用 得 多 。 


看 看 这 个 庞大 的 测试 : 





def test_vaLidation_errors_sent_back_to_home_page_tempLate(seLf) : 
response = self.client.post('/lists/new', data={'text': ''}) 
self.assertEqual(List.objects.all().count(), 0) 
self.assertEqual(Item.objects.all().count(), 0) 
self.assertTemplateUsed(response, 'home.html') 
expected_error = escape("You can't have an empty list item") 
self.assertContains(response, expected error) 





它 肯 定 没有 下 面 这 3 个 单独 的 测试 有 用 : 





def test invalid input means_nothing_saved_to _db(self): 
self.post_invalid input() 
self.assertequal(item.objects.all().count(), 0) 


def test invalid input_renders_list template(self): 
response = self.post_ invalid input() 
self.asserttemplateused(response, 'list.html') 


def test invalid input_renders_form with_errors(self): 
response = self.post_ invalid input() 
self.assertisinstance(response.context['form'], existinglistitemform) 
self.assertcontains(response, escape(empty_list error)) 





因为 ， 对 前 一 种 方式 来 说 ， 如 果 靠 前 的 断言 失败 了 ， 后 面 的 断言 就 不 会 执行 。 所 以 ， 如 果 
视图 不 小 心 把 POST 请 求 中 的 无 效 数据 存 入 数据 库 ， 前 面 的 断言 会 失败 ， 这 样 就 无 法 确认 
使 用 的 模板 是 否 正 确 以 及 有 没有 渲染 表单 。 使 用 后 一 种 方式 则 能 更 轻易 的 分 辨 出 到 底 哪 一 
部 分 能 用 、 哪 一 部 分 不 能 
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从 CBGYV 中 学 到 的 经 验 
。 基于 类 的 通用 视图 可 以 做 任何 事 
虽然 不 一 定 总 是 知道 到 底 怎 么 回 事 ， 但 使 用 基于 类 的 视图 几乎 可 以 做 任何 事 。 
。 只 有 一 个 断言 的 单元 测试 有 助 于 重 构 
有 单元 测试 检查 什么 可 用 什么 不 可 用 ， 使 用 不 同 的 基本 范式 修改 视图 的 实现 方式 就 
容易 多 了 。 








基于 类 的 Django 视 图 | 397 








附录 C 


使 用 Ansible 配 置 服务 器 





用 Fabric 自动 把 新 版 源码 部 署 到 服务 器 上 ,但 配置 新 服务 器 的 过 程 以 及 更 新 Nginx 和 
Gunicorn 配置 文件 的 操作 ， 都 还 是 手动 完成 。 
































这 类 操作 越 来 越 多 地 交 给 “配置 管理 ”或 “持续 部 署 ” 工 具 完成 。 其 中 ，Chef 和 Puppet 
最 受 欢迎 ， 而 在 Python 领域 则 是 Salt 和 Ansible。 





对 


这 些 工 具 中 ，Ansible 最 容易 上 手 ， 只 需 两 个 文件 就 可 以 使 用 : 

















pip install ansible # 可 惜 只 能 用 Python 2 





表单 文件 deploy_tools/inventory.ansible 定义 可 以 在 哪些 服务 器 中 运行 : 





一 





deploy_tools/inventory.ansible 
[livel] 
superlists.ottg.eu 


[staging] 
superlists-staging.ottg.eu 


[locall] 
LocaLhost ansible_ssh_port=6666 ansible_host=127.0.0.1 


(local 条 目 只 是 个 示例 ， 在 我 的 设备 中 是 个 Virtualbox 虚拟 主机 ， 并 且 为 22 和 80 端口 设 
定 了 端口 转发 。) 
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C.1 安装 系统 包 和 Nginx 
另 一 个 文件 是 “脚本 ”(playbook)， 定 义 在 服务 器 中 做 什么 。 这 个 文件 的 内 容 使 用 YAML 
句法 编写 : 








deploy_tools/provision.ansible.yaml 


- hosts: all 
sudo: yes 
vars: 


host: Sinventory_hostname 


tasks : 
- name: make sure required packages are installed 
apt: pkg=nginx,git,python3,python3-pip state=present 
- Name: make sure virtualenv is installed 
shell: pip3 install virtualenv 


- Name: allow long hostnames in nginx 
lineinfile: 
dest=/etc/nginx/nginx.conf 
regexp='(\s+)#? ?server_names_hash_bucket_size' 
backrefs=yes 
line='\1server_names_hash_bucket_size 64;' 


name: add nginx config to sites-available 
template: src=./nginx.conf.j2 
dest=/etc/nginx/sites-available/{{ host }} 
notify: 
- restart nginx 


name: add symlink in nginx sites-enabled 
file: src=/etc/nginx/sites-available/{{ host }} 
dest=/etc/nginx/sites-enabled/{{ host }} state=link 
notify: 
- restart nginx 








为 了 方便 ， 在 “vars” 部 分 定义 了 一 个 变量 “host”。 这 个 变量 可 以 在 不 同 的 文件 名 中 使 用 ， 
也 可 以 传 给 配置 文件 。 变 量 的 值 是 $inventory_hostname， 即 当前 所 在 服务 器 的 域名 。 














在 “tasks” 部 分 ， 使 用 apt 安装 所 需 的 软件 ， 再 使 用 正则 表达 式 替 换 Nginx 配置 ， 允 许 
使 用 长 域名 ， 然 后 使 用 模板 创建 Nginx 配置 文件 。 这 个 模板 由 第 8 章 保存 在 deploy tools/ 
nginx.template.conf 中 的 模板 文件 修改 而 来 ， 不 过 现在 指定 使 用 一 种 模板 引擎 
和 Django 的 模板 句法 很 像 : 














Jinja2， 
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deploy_tools/nginx.confj2 


server { 
listen 80; 
server_name {{ host }}; 


location /static { 
alias /home/harry/sites/{{ host }}/static; 


} 


location / { 
proxy_set_header Host $host; 
proxy_pass http://unix:/tmp/{{ host }}.socket; 


C.2 ”配置 Gunicorn， 使 用 处 理 程序 重启 服务 
脚本 剩余 的 内 容 如 下 : 


deploy_tools/provision.ansible.yaml 


- Name: write gunicorn init script 
template: src=./gunicorn-upstart.conf.j2 
dest=/etc/init/gunicorn-{{ host }}.conf 
notify: 
- restart gunicorn 


- Name: make sure nginx is running 
service: name=nginx state=running 
- Name: make sure gunicorn is running 
service: name=gunicorn-{{ host }} state=running 


handlers: 
- Name: restart nginx 


service: name=nginx state=restarted 


- Name: restart gunicorn 
service: name=gunicorn-{{ host }} state=restarted 


创建 Gunicorn 配置 文件 还 要 使 用 模板 : 


deploy_tools/gunicorn.upstart.confj2 


description "Gunicorn server for {{ host }}" 


start on net-device-up 
stop on shutdown 


respawn 
chdir /home/harry/sites/{{ host }}/source 


exec ../virtualenv/bin/gunicorn \ 
--bind unix:/tmp/{{ host }}.socket \ 
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--access-logfile ../access.log \ 
--error-logfile ../error.log \ 
superlists.wsgi:application 





然后 定义 两 个 处 理 程序 ， 重 启 Nginx 和 Gunicom。Ansible 很 智能 ， 如 果 多 个 步骤 部 调用 同 
个 处 理 程序 ， 它 会 等 前 一 个 执行 完 再 调用 下 一 个 。 


























这 样 就 行 了 ! 执行 配置 操作 的 命令 如 下 : 





ansible-playbook -i ansible.inventory provision.ansible.yaml --limit=staging 


详细 信息 参阅 Ansible 的 文档 (http://www.ansibleworks.com/docs/) 。 


C.3 接 下 来 做 什么 


我 只 是 简单 介绍 了 Ansible 的 功能 。 部 署 过 程 的 自动 化 程度 越 高 ， 你 对 部 署 的 自信 也 越 高 。 
接 下 来 ， 你 可 以 完成 下 面 儿 件 事 。 











C.3.1 把 Fabric 执 行 的 部 署 操 作 交 给 Ansible 

已 经 看 到 Ansible 可 以 帮助 完成 配置 过 程 中 的 某 些 操作 ， 其 实 它 可 以 完成 几乎 所 有 部 署 操 
作 。 你 可 以 试 一 下 ， 看 能 否 扩 写 脚本 把 当前 Fabric 部 署 脚本 中 的 所 有 操作 都 交 给 Ansible 
完成 ， 包 括 必 要 情况 下 重启 时 发 出 提醒 。 


C.3.2 ”使 用 Vagrant 搭 建 本 地 虚拟 主机 
在 过 渡 网 站 中 运行 测试 能 让 我 们 相信 网 站 上 线 后 也 能 正常 运行 。 不 过 也 可 以 在 本 地 设备 中 
使 用 虚拟 主机 完成 这 项 操作 。 






























































下 载 Vagrant 和 Virtualbox， 看 你 能 否 使 用 Vagrant 在 自己 的 电脑 中 搭建 一 个 开发 服务 器 ， 
以 及 使 用 Ansible 脚本 把 代码 部 署 到 这 个 服务 器 中 。 设 置 功 能 测试 运行 程序 ， 让 功能 测试 
能 在 本 地 虚拟 主机 中 运行 。 





如 果 在 团队 中 工作 ， 编 写 一 个 Vagrant 配置 脚本 特别 有 用 ， 因 为 它 能 帮助 新 加 入 的 开发 者 
搭建 和 你 们 使 用 的 一 模 一 样 的 服务 器 。 
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附录 DD 


测试 数据 库 迁 移 

















Django-migrations 及 其 前 身 South 已 经 出 现 好 多 年 了 ， 所 以 一 般 没 必要 测试 数据 库 迁 移 。 
但 有 时 我 们 会 使 用 一 种 危险 的 迁移 ， 即 引入 新 的 数据 完整 性 约束 。 我 第 一 次 在 过 渡 环 境 中 
运行 这 种 迁移 脚本 时 ， 遇 到 一 个 错误 。 








在 大 型 项 目 中 ， 如 果 有 敏感 数据 ， 在 生产 数据 中 执行 迁移 之 前 ， 你 可 能 想 先 在 一 个 安全 的 
环境 中 测试 ， 增 加 一 些 自信 。 你 可 以 在 本 书 开发 的 示例 应 用 中 先 练习 一 下 。 

















测试 迁移 的 另 一 个 常见 原因 是 测速 一 一 执行 迁移 时 经 常 要 把 网 站 下 线 ， 而 且 如 果 数 据 集 较 
大 ， 用 时 并 不 短 。 所 以 最 好 提前 知道 迁移 要 执行 多 长 时 间 。 


D.1 尝试 部 署 到 过 渡 服务 器 


在 第 14 章 ， 当 我 第 一 次 尝试 部 署 新 添加 的 验证 约束 条 件 时 ， 遇 到 了 如 下 问题 : 





$ cd deploy_tools 
$ fab deploy:host=elspeth@superlists-staging.ottg.eu 
[. wl 


Running migrations: 

Applying lists.0005_list item unique_together...Traceback (most recent call 
last): 

File "/uysr/local/lib/python3.3/dist-packages/django/db/backends/utils.py", 
Line 61, in execute 

return self.cursor.execute(sql, params) 

File 
"/usr/local/lib/python3.3/dist-packages/django/db/backends/sqlite3/base.py", 
Line 475, in execute 
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return Database.Cursor.execute(seLf，query，params) 
sqlite3.IntegrityError: columns list_id, text are not unique 


[...] 


情况 是 这 样 ， 数 据 库 中 某 些 现 有 的 数据 违反 了 完整 性 约束 条 件 ， 所 以 当 我 尝试 应 用 约束 条 


件 时 ， 数 据 库 表达 了 不 满 。 
为 了 处 理 这 种 问题 ， 需 要 执行 “数据 迁移 " 。 首 先 ， 要 在 本 地 搭建 一 个 测试 环境 。 


D.2 在 本 地 执行 一 个 用 于 测试 的 迁移 


使 用 线 上 数据 库 的 副本 测试 迁移 。 


























测试 时 使 用 真实 数据 一 定 要 小 心 、 小 心 、 再 小 心 。 例 如 ， 数 据 中 可 能 有 客户 
的 真实 电子 邮件 地 址 ， 但 你 并 不 想 不 小 心 给 他 们 发 送 一 堆 测试 邮件 。 我 可 是 
栽 过 跟头 的 。 





D.2.1 输入 有 问题 的 数据 


在 线 上 网 站 中 新 建 一 个 清单 ， 输 入 一 些 重复 的 待 办 事项 ， 如 图 D-1 所 示 。 























To-Do lists - Mozilla Firefox x 
File Edit View History Bookmarks Tools Help 
|DTo-Dolists | 守 | 
所 ottg.ey, ”| 图 coogle av 会 和 " 
| | t 
duplicate| 
1: a list with duplicate items 
2: duplicate 
3: duplicate 
4: duplicate 
@- x S59 


图 D-1: 一 个 清单 ， 待 办 事项 有 重复 
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D.2.2 ”从 线 上 网 站 中 复制 测试 数据 
从 线 上 网 站 中 复制 数据 库 : 


$ scp elspeth@superlists.ottg.eu:\ 
/home/elspeth/sites/superlists.ottg.eu/database/db.sqlite3 . 
$ mv ../database/db.sqlite3 ../database/db.sqlite3.bak 

$ mv db.sqlite3 ../database/db.sqLite3 


D.2.3 确认 的 确 有 问题 
现在 ， 本 地 有 一 个 还 未 执行 迁移 的 数据 库 ， 而 且 数 据 库 中 有 一 些 问题 数据 。 如 果 莹 试 执 行 


migrate 命令 ， 会 看 到 一 个 错误 : 

















$ python3 manage.py migrate --migrate 
python3 manage.py migrate 
Operations to perform: 


Ei 


Running migrations: 


[sd 


Applying lists.0005_ list item unique together...Traceback (most recent call 
last): 
|W 


return Database.Cursor .execute(self, query, params) 
sqlite3.IntegrityError: columns list id, text are not unique 


D.3 插入 一 个 数据 迁移 

数据 迁移 (https://docs.djangoproject.com/en/dev/topics/migrations/#data-migrations) 是 一 种 
特殊 的 迁移 ， 目 的 是 修改 数据 库 中 的 数据 ， 而 不 是 变更 模式 。 应 用 完整 性 约束 之 前 ， 先 要 
执行 一 次 数据 迁移 ， 把 重复 数据 删除 。 具 体 方法 如 下 : 





$ git rm lists/migrations/0005_list item_unique_together.py 
$ python3 manage.py makemigrations lists --empty 
Migrations for 'lists': 
0005_auto_20140414_2325.py: 
$ mv lists/migrations/0005_ lists/migrations/0005_remove_duplicates.py* 


数据 迁移 的 详情 参阅 Django 文档 (https://docs.djangoproject.com/en/dev/topics/migrations/ 
#data-migrations)。 下 面 是 修改 现 有 数据 的 方法 : 








lists/migrations/0005 remove _ duplicates.py 


# encoding: utf8 
from django.db import models, migrations 


def find_dupes(apps, schema_editor): 
List = apps.get model("lists", "List") 
for list_ in List.objects.all(): 
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items = list_ .item set.all() 
texts = set() 
for ix, item in enumerate(itenms): 
if item.text in texts: 
item.text = '{} ({})'.format(item.text, ix) 
item.save() 
texts.add(item. text) 


class Migration(migrations.Migration): 


dependencies = [ 
('lists', '0004 item list'), 
] 


operations = [ 
migrations.Runpython(find_dupes), 


] 


重新 创建 以 前 的 迁移 


使 用 makemigrations 重新 创建 以 前 的 迁移 ， 确 保 这 是 第 6 个 迁移 ， 而 且 还 明确 依赖 于 66995， 
即 那个 数据 迁移 : 
$ python3 manage.py makemigrations 
Migrations for 'lists': 
0006_auto_20140415_0018.py: 


- Alter unique together for item (1 constraints) 
$ mv lists/migrations/0006_* lists/migrations/0006_unique_together.py 


D.4 一 起 测试 这 两 个 迁移 
现在 可 以 在 线 上 数据 中 测试 了 ， 





$ cd deploy_tools 
$ fab deploy:host=elspeth@superlists-staging.ottg.eu 
Escal 


还 要 重启 服务 器 中 的 Gunicorn 服务 : 
elspeth@server:$ sudo restart gunicorn-superlists.ottg.eu 
然后 可 以 在 过 渡 网 站 中 运行 功能 测试 : 


$ python3 manage.py test functional_tests --liveserver=superlists-staging.ottg.eu 
Creating test database for alias 'default'... 


Ran 4 tests in 17.308s 


OK 
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看 起 来 一 切 正常 。 现 在 部 署 到 线 上 服务 器 ; 


$ fab deploy --host=superlists.ottg.eu 
[superlists.ottg.eu] Executing task 'deploy' 


[se 


A 


最 后 ， 执 行 git add lists/migrations、git commit 等 命令 。 


D.5 小 结 


这 个 练习 的 主要 目的 是 编写 一 个 数据 迁移 ， 在 一 些 真 实 的 数据 中 测试 。 当 然 ， 这 只 是 测 
试 迁 移 的 千 万 种 方式 之 一 。 你 还 可 以 编写 自动 化 测试 ， 比 较 运 行 迁移 前 后 数据 库 中 的 内 
容 ， 确 认 数 据 还 在 。 也 可 以 为 数据 迁移 中 的 辅助 函数 单独 编写 单元 测试 。 你 可 以 再 多 花 
点 儿 时 间 统 计 迁 移 所 用 的 时 间 ， 然 后 实验 多 种 提速 的 方法 ， 例 如 ， 把 迁移 的 步骤 分 得 更 
细 或 更 党 统 。 




















记 住 ， 这 种 需求 很 少见 。 根 据 我 的 经 验 ， 我 使 用 的 迁移 ，99% 都 不 需要 测试 。 不 过 ， 在 你 
的 项 目 中 可 能 需要 。 和 希望 读 过 这 个 附录 之 后 ， 你 知道 怎么 着 手 测试 迁移 。 








关于 测试 数据 库 迁 移 

。 小 心 引 入 约束 的 迁移 
99% 的 迁移 都 没 问 题 ， 但 是 如 果 迁 移 为 现 有 的 列 引 入 了 新 的 约 东 条件 ， 就 像 前 面 那 
个 例子 ， 一 定 要 小 心 。 

。 测试 迁移 的 执行 速度 
一 旦 项 目 变 大 ， 你 就 应 该 考虑 测试 迁移 所 用 的 时 间 。 执 行 数据 库 迁 移 时 往往 要 下 线 
网 站 ， 因 为 修改 模式 可 能 要 锁定 数据 表 (取决 于 使 用 的 数据 库 种 类 ) ， 直 到 操作 完 
成 为 止 。 所 以 最 好 在 过 渡 网 站 中 测试 迁移 要 用 多 长 时 间 。 


。 使 用 生产 数据 的 副本 时 要 格外 小 心 
为 了 测试 迁移 ， 要 在 过 渡 网 站 的 数据 库 中 填充 与 生产 数据 等 量 的 数据 。 具 体 怎 么 做 
不 在 本 书 范畴 之 内 ， 不 过 我 要 提醒 一 下 : 如 果 直 接 转 储 生产 数据 库 导 入 过 渡 网 站 的 
数据 库 中 ， 一 定 要 十 分 小 心 ， 因 为 生产 数据 中 包含 真实 客户 的 详细 信息 。 有 一 次 在 
过 渡 服 务 器 中 自动 处 理 刚 导入 的 生产 数据 副本 时 ， 我 不 小 心 发 送 了 好 几 百 张 错误 的 
发 票 。 那 天 下 午 过 得 可 不 愉快 。 
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附录 E 


接 下 来 做 什么 





下 面 是 我 建议 你 接 下 来 可 以 研究 的 一 些 事情 ， 目 的 是 提升 测试 技能 ， 以 及 把 (写作 本 书 时 
的 ) 新 技术 应 用 到 Web 开发 中 。 


如 果 以 后 不 再 添加 附录 ， 我 希望 至 少 为 每 个 话题 写 一 篇 博客 文章 ， 也 编写 一 些 示例 代码 。 
所 以 请 读者 一 定 要 访问 http://www.obeythetestinggoat.com， 看 有 没有 更 新 。 


或 者 你 可 以 抢 在 我 前 面 ， 自 己 写 博客 文章 ， 记 录 你 尝试 其 中 任何 一 件 事 的 过 程 。 


我 很 乐意 回答 问题 以 及 为 这 些 话题 提供 提示 和 指引 ， 所 以 如 果 你 想 尝试 做 某 件 事 ， 但 卡 住 
了 ， 别 犹 浅 ， 联 系 我 吧 ， 电 子 邮 件 地 址 是 obeythetestinggoat@gmail.com。 


E.1 提醒 一 一 站 内 提醒 以 及 邮件 提醒 
如 果 有 人 把 清单 分 享 给 基 个 用 户 ， 能 提醒 这 个 用 户 就 好 了 。 


你 可 以 使 用 django-notifications， 在 用 户 下 次 刷新 页 面 时 显示 一 个 消息 。 在 这 个 功能 的 功能 
测试 中 需要 两 个 浏览 器 。 












































或 者 ， 也 可 以 通过 电子 邮件 提醒 。 研 究 一 下 Django 对 测试 电子 邮件 的 支持 ， 然 后 你 会 发 
现 ， 测 试 的 过 程 需要 发 送 真 的 电子 邮件 。 使 用 IMAPClient 库 可 以 从 网 页 邮件 测试 账户 中 
获取 真实 的 电子 邮件 。 
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E.2 换 用 Postgres 


SQLite 对 小 型 数据 库 来 说 很 好 ， 但 如 果 有 不 止 一 个 Web 职 程 处 理 请 求 ， 那 就 无 法 胜任 了 。 
现在 ，Postgres 是 大 家 最 喜欢 的 数据 库 ， 请 弄 清 怎么 安装 及 配置 Postgres。 


你 要 找 一 个 文件 保存 本 地 、 过 渡 服 务 器 和 生产 服务 器 中 Postgres 的 用 户 名 和 密码 。 因 为 ， 
为 了 安全 ， 你 或 许 不 想 把 这 些 信息 放 入 代码 仓库 。 你 得 找到 一 种 方法 ， 让 部 署 脚 本 把 这 些 
信息 传 入 命令 行 。 流 行 的 解决 方法 之 一 是 在 环境 变量 中 存储 这 些 信息 。 














你 可 以 实验 一 下 ， 看 单元 测试 在 SQLite 中 运行 相 比 在 Postgres 中 运行 有 多 快 。 为 此 ， 你 可 
以 在 本 地 设备 中 使 用 SQLite， 仅 做 测试 ， 但 在 CI 服务 器 中 使 用 Postgres。 


E.3 在 不 同 的 浏览 器 中 运行 测试 





Selenium 支持 各 种 不 同 的 浏览 器 ， 包 括 Chrome 和 Internet Exploder。 尝 试 在 这 两 种 浏览 器 


中 运行 功能 测试 组 件 ， 看 看 有 没有 什么 异常 表现 。 








你 还 应 该 试 试 无 界面 浏览 器 ， 比 如 PhantomJS。 











根据 我 的 经 验 ， 在 不 同 的 浏览 器 中 测试 能 暴露 Selenium 测试 中 的 各 种 条 件 竞 争 ， 而 且 可 能 





还 要 更 多 地 使 用 交互 等 待 模式 〈 尤 其 是 在 PhantomJS 中 )。 


E.4 400 和 500 测 试 


专业 的 网 站 需要 漂亮 的 错误 页 面 。400 页 面 的 测试 方法 很 简单 ， 





或 许 得 编写 一 个 故意 抛 出 异常 的 视图 。 





E.5 ” Django 管理 后 台 





假设 有 个 用 户 发 邮件 声称 某 个 匿名 清单 是 他 的 。 为 此 ， 想 实现 一 


的 管理 员 在 管理 后 台中 手动 修改 记录 。 








弄 清 楚 怎 么 启用 和 使 用 管理 后 台 。 编 写 一 个 功能 测试 ， 首 先 由 一 
一 个 清单 ， 然 后 管理 员 登 录 ， 进 入 管理 后 台 ， 把 这 个 清单 指派 给 




















即 可 在 “My Lists” 页 面 看 到 这 个 清单 。 








E.6 研究 一 种 BDD 工 具 





BDD 是 行为 驱动 开发 (Behaviour-Driven Development) 的 简称 。 
域 特定 语言 (Domain-Specific Language，DSL) 编写 功能 测试 ， 


但 如 果 想 测试 500 页 面 ， 


种 手动 解决 方案 ， 由 网 站 








个 未 登录 的 普通 用 户 创建 
这 个 用 户 ， 然 后 这 个 用 户 





这 种 开发 方式 使 用 一 种 领 
提升 对 人 类 的 可 读 性 。 试 
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一 下 Lettuce (Python BDD 框架 )， 用 它 重 写 一 个 现 有 的 功能 测试 ， 或 者 编写 一 个 全 新 的 功 
能 测试 。 


E.7 编写 一 些 安全 测试 
扩展 针对 登录 、“My Lists” 页 面 和 分 享 功能 的 测试 ， 看 看 需要 怎么 编写 测试 确保 用 户 只 能 
做 有 权限 做 的 事情 . 


E.8 测试 优雅 降级 


如 果 Persona 不 可 用 会 发 生 什么 ? 是 否 至 少 可 以 向 用 户 显示 一 个 致歉 背 息 ? 














。 提示 : 模拟 Persona 服务 不 可 用 的 方式 之 一 是 修改 主机 文件 〈 路 径 是 /etc/ hosts 或 cn 
Windows\Sytem32\drivers\etc)。 记 得 在 测试 的 tearDown 方法 中 撤销 改动 。 
。 要 同时 考虑 服务 器 端 和 客户 端 。 


ry Ab 2 MA 
E.9 缓存 和 性 能 测试 
和 弄 清楚 如 何 安装 和 配置 nemcached， 以 及 如 何 使 用 Apache 的 ab 工具 运行 性 能 测试 。 有 缓存 


和 没有 缓存 两 种 情况 ， 网 站 的 性 能 如 何 ? 你 能 否 编写 一 个 自动 化 测试 ， 如 果 检 凋 到 没 启用 组 
存 就 失败 ? 应 该 怎么 处 理 可 拍 的 缓存 失效 问题 ? 测试 能 否 帮 你 确认 缓存 失效 逻辑 是 可 靠 的 ? 























E.10 JavaScript MVC 框 架 

现今 ， 在 客户 端 实现 “模型 -视图 -控制 器 ”(Model-View-Controller，MVC) 模式 的 
JavaScript 库 比较 流行 。 这 种 库 喜欢 使 用 待 办 事项 清单 应 用 做 演示 ， 所 以 把 这 个 网 站 改写 
成 单 页 网 站 应 该 很 容易 。 在 单 页 网 站 中 ， 添 加 清单 的 所 有 操作 都 由 JavaScript 代码 完成 。 





























选 一 个 框架 ，Backbone.js 或 Angular.js， 探 究 一 下 怎么 实现 。 在 各 种 框架 中 编写 单元 测试 
都 有 各 自 的 方式 。 学 习 一 种 方式 ， 一 直 使 用 下 去 ， 看 你 是 否 喜欢 。 











E.11 异步 和 websocket 


假设 两 个 用 户 同时 编辑 同一 个 清单 ， 如 果 能 看 到 实时 更 新 ， 即 一 个 用 户 添 加 待 办 事项 之 
后 ， 另 一 个 用 户 立 即 就 能 看 到 ， 是 不 是 很 棒 ? 这 种 功能 可 以 使 用 websocket 在 客户 端 和 服 
务 器 之 间 建 立 持久 连接 实现 。 























研究 一 种 Python 异步 Web 服务 器 ，Tornado、gevent 或 Twisted， 看 你 是 否 能 用 它 实现 动 
态 提醒 
TNEH 下 。 
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测试 时 需要 两 个 浏览 器 实例 (就 像 在 分 享 功 能 的 测试 中 一 样 )， 检 查 不 刷新 页 面 的 情况 下 ， 
操作 提醒 是 否 会 出 现在 另 一 个 浏览 器 实例 中 。 


E.12 换 用 py.test 


使 用 py.test 编写 单元 测试 不 用 写 那 么 多 样板 代码 。 尝 试 使 用 py.test 改写 一 些 单元 测试 。 或 
许 需 要 使 用 插件 才能 和 Django 无 颖 配合 。 


E.13 客户 端 加 密 
这 个 比较 有 趣 : 如 果 用 户 太 偏执 ， 不 再 相信 NSA (美国 国家 安全 局 ) ， 觉 得 把 清单 放 在 云 


端 不 安全 该 怎么 办 ? 开发 一 种 JavaScript 加 密 系统 吗 ， 在 待 办 事项 发 给 服务 器 之 前 ， 用 户 
可 以 输入 一 个 密码 。 































































































的 测试 ， 可 以 这 么 写 : 管理 员 登 录 Django 管理 后 台 ， 查 看 用 户 的 清单 ， 确 
清单 中 的 待 办 事项 在 数据 库 中 是 否 使 用 密 文 存储 。 


E.14 你 的 建议 


你 觉得 我 应 该 在 这 个 附录 中 写 些 什么 ? 提 些 建议 吧 ! 
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附录 F 
速 查 表 





人 们 都 喜欢 速 查 表 ， 所 以 我 根据 每 章 末 尾 旁 注 中 的 总 结 制 作 了 这 个 速 查 表 ， 目 的 是 提醒 
你 ， 并 且 链 接 到 具体 章节 ， 以 此 唤起 你 的 记忆 。 和 希望 这 个 速 查 表 有 用 。 


F.1 项 目 开始 阶段 


。 先 构思 一 个 用 户 故 事 ， 然 后 转换 成 第 一 个 功能 测试 

。 选择 一 个 测试 框架 一 一 unittest 不 错 ，py.test 和 nose 也 有 一 定 优势 ， 

。 运行 功能 测试 ， 得 到 第 一 个 预期 失败 ， 

。 选择 一 个 Web 框架 ， 例 如 Django， 然 后 弄 清 如 何在 选中 的 框架 中 运行 单元 测试 ， 
。 针对 目前 失败 的 功能 测试 编写 第 一 个 单元 测试 ， 看 着 它 失 败 ， 

。 做 第 一 次 提交 ， 把 代码 提交 到 VCS (例如 Git) 中 。 























相关 章节 : 第 1、2、3 章 。 


F.2 TDD 基 本 流程 


。 双 循 环 TDD (图 F-1) ， 

。 遇 红 ， 变 绿 ， 重 构 ; 

。 三 角 法 ， 

。 便签 ; 

。 “三 则 重 构 ” 原 则 ， 

。 “从 一 个 可 运行 状态 到 另 一 个 可 运行 状态 ”， 
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。 “YAGNI” 原 则 。 


应 用 是 否 





人 需要 重 构 ? 





“单元 测试 /编写 代码 ”循环 





图 F-1: 包含 功能 测试 和 单元 测试 的 TDD 流程 


相关 章节 : 第 4、5、6 章 。 


F.3 ”测试 不 止 要 在 开发 环境 中 运行 


。 尽早 进行 系统 测试 。 确 保 各 组 件 能 正常 协作 ， 包 括 Web 组 件 、 静 态 内 容 和 数据 库 。 
。 搭建 和 生产 环境 一 样 的 过 渡 环 境 ， 在 这 个 环境 中 运行 功能 测试 。 
。 自动 部 署 过 渡 环 境 和 生产 环境 : 
一 PaaS 与 VPS 
— Fabric; 
- 配置 管理 工具 (Chef，Puppet，Salt，Ansible) ; 
— Vagrant。 
。 彻底 弄 清楚 部 署 的 主要 步骤 : 数据 库 、 静 态 文 件 、 依 赖 、 如 何 定制 设 定 等 。 
。 尽早 搭建 CI 服务器， 运行 测试 不 能 只 靠 自律 。 
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相关 章节 : 第 8、9、20 章 ， 附 录 C。 


F.4 通用 的 测试 最 佳 实践 
。 每 个 测试 只 能 测试 一 件 事 ， 

。 应 用 的 一 个 源码 文件 对 应 一 个 测试 文件 ， 
。 不 管 函数 和 类 多 么 简单 ， 都 至 少 要 编写 一 个 占 位 测试 ， 
。“ 别 测试 常量 ”， 

。 尝试 测试 行为 ， 而 不 是 实现 方式 ; 

。 不 能 顺 着 代码 的 逻辑 思考 ， 还 要 考虑 边缘 情况 和 有 错误 的 情况 。 























相关 章节 : 第 4、10、11 章 。 


F.5 Selenium/ 功 能 测试 最 佳 实 践 


。 相 较 隐 式 等 待 ， 多 使 用 显 式 等 待 和 交互 等 待 模式 ; 

。 避免 编写 重复 的 测试 代码 一 一 可 以 在 基 类 中 定义 辅助 方法 ， 也 可 以 使 用 页 面 模式 ; 

。 避免 多 次 重复 测试 同一 个 功能 。 如 果 测 试 中 有 耗 时 操作 (例如 登录 )， 可 以 找 一 种 方法 
在 其 他 测试 中 跳 过 这 一 步 (但 要 小 心 看 起 来 无 关 的 功能 相互 之 间 的 异常 交互 ) ， 

。 使 用 BDD 工具 ， 作 为 组 织 功能 测试 的 另 一 种 方式 。 


























相关 章节 : 第 17、20、21 章 。 


F.6 由 外 而 内 ， 测 试 隔离 与 整合 测试 ， 模 拟 技术 
别 忘 了 编写 测试 的 初 袁 ， 


。 确保 正确 性 ， 避 免 回 归 ， 
。 帮助 我 们 写 出 简洁 可 维护 的 代码 ， 
。 实现 一 种 快速 高 效 的 工作 流程 。 








记 住 这 几 点 之 后 ， 再 看 不 同 的 测试 类 型 以 及 各 自 的 优 缺 点 。 





。 功能 测试 
。 从 用 户 的 角度 出 发 ， 最 大 程度 上 保证 应 用 可 以 正常 运行 ; 
。 但 是 ， 反 馈 循环 用 时 长 ， 
。 而 且 无 法 帮助 我 们 写 出 简洁 的 代码 。 








。 整合 测试 (依赖 于 ORM 或 Django 测试 客户 端 等 ) 
。 编写 速度 快 ， 
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。 易于 理解 ; 

。 发 现任 何 集成 问题 都 会 提醒 你 ; 

。 但 是 ， 并 不 总 能 得 到 好 的 设计 (这 取决 于 你 自己 ! ) ; 
。 而 且 一 般 运 行 速度 比 隔离 测试 慢 。 








。 隔离 测试 (使 用 驭 件 ) 
。 涉及 的 工作 量 最 大 ， 
。 可 能 难以 阅读 和 理解 ; 
。 但 是 ， 这 种 测试 最 能 引导 你 实现 更 好 的 设计 ， 
。 而 且 运 行 速度 最 快 。 














如 果 你 发 现 编写 测试 时 要 使 用 很 多 驭 件 ， 而 且 感 觉 很 痛苦 ， 那 么 记得 要 “倾听 测试 的 心 
声 ” 一 一 使 用 模拟 技术 写 出 的 丑陋 测试 试图 告诉 你 ， 代 码 可 以 简化 。 




















相关 章节 : 第 18、19、22 章 。 
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附录 G 
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作者 简介 

Harry 的 童年 很 美好 ， 他 在 Thomson T-07 〈 当 时 在 法 国 很 流行 ， 按 键 后 会 发 出 “ 踊 喉 ” 
声 ) 这 种 8 位 电脑 上 摆弄 BASIC， 长 大 后 做 了 几 年 经 管 顾问 ， 但 完全 不 快乐 。 而 后 他 发 
现 了 自己 真正 的 极 客 潜质 ， 又 很 幸运 地 遇 到 了 一 些 极限 编程 狂热 者 ， 参 与 开发 了 电子 制 
表 软 件 的 先驱 Resolver One， 不 过 很 可 惜 ， 这 个 软件 现在 已 经 退出 历史 姓 台 。 他 目前 在 
PythonAnywhere LLP 公司 工作 ， 而 且 在 各 种 演讲 、 研 讨 会 和 开发 者 大 会 上 积极 推广 TDD。 





封面 介绍 

本 书 封面 上 的 动物 是 开 司 米 山羊 。 虽 然 所 有 山羊 部 长 有 开 司 米 ， 但 人 类 只 选择 培育 这 种 山 
羊 ， 产 出 能 满足 商用 数量 的 开 司 米 ， 所 以 一 般 只 有 这 种 山羊 叫 “ 开 司 米 山羊 "。 因 此 ， 开 
司 米 山羊 是 一 种 荔 养 的 家 山羊。 





开 司 米 山 羊 长 有 一 层 异 常 柔 软 顺 滑 的 内 层 绒毛 ， 外 履 一 层 粗糙 的 羊毛 一 一 这 就 是 山羊 的 两 
层 羊 毛 。 开 司 米 在 冬季 长 成 ， 目 的 是 补充 外 层 羊 毛 〈 这 种 毛 叫 “ 针 毛 ") 的 御寒 能 力 。 开 
司 米 中 毛发 的 卷曲 量 决定 了 它 的 重量 和 保暖 性 能 。 


“ 开 司 米 ” 这 个 名 字 出 自 印 度 次 大 陆 上 的 克什米尔 山谷 地 区 。 在 这 一 地 区 ， 纺 织品 已 经 出 
现 几 千年 了 。 现 在 的 克什米尔 地 区 ， 开 司 米 山羊 数量 不 断 减 少 ， 所 以 不 再 出 口 开 司 米 纤 
维 。 现 在 ， 大 多 数 开 司 米 毛 织 品 部 出 自 阿 富 汗 、 伊 朗 、 外 蒙古 和 印度 ， 以 及 占 主导 地 位 的 
中 国 。 


开 司 米 山 羊 的 羊毛 有 多 种 颜色 和 颜色 搭配 。 雄 性 和 坎 性 都 长 有 特 角 ,夏季 可 用 于 散热 , 干 
农活 时 主人 也 能 用 它们 更 好 地 榨 制 其 他 山羊 。 


封面 图 片 出 自 Wood 的 Animate Creation 一 书 。 
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关注 图 灵 教 育 关注 图 灵 社区 
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在 线 出 版 电子 书 《 码 农 》 杂 志 图 灵 访 谈 …… 
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QQ 联系 我 们 


图 灵 读 者 官方 群 I: 218139230 
图 灵 读 者 官方 群 [I[: 164939616 


人 


一 一 一 一 微 博 联系 我 们 





官方 账号 : @ 图 灵 教 育 @ 图 灵 社 区 @ 图 灵 新 知 
市 场合 作 : @ 图 灵 责 野 

写作 本 版 书 : @ 图 灵 小 花 @ 图 灵 张 霞 

翻译 英文 书 : @ 朱 剖 ituring @ 楼 伟 珊 

翻译 日 文书 或 文章 : @ 图 灵 乐 声 

翻译 韩文 书 : @ 图 灵 陈 曦 

电子 书 合作 : @hi_jeanne 

图 灵 访 谈 /《 码 农 》 杂 志 : @ 李 盼 ituring 

加 入 我 们 : @ 王 子 是 好 人 
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一 一 一 一 微 信 联系 我 们 
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Python Web 开 发 : 测试 驱动 方法 


本 书 手把手 教 你 从 头 开始 开发 一 个 真正 的 Web 应 用 ， 并 且 展 示 使 用 Python “这 本 书 很 棒 、 很 有 趣 ， 所 讲 的 全 都 
做 测试 驱动 开发 (TDD) 的 优势 。 你 将 学 到 如 何在 开发 应 用 的 每 一 个 部 。 是 重点 知识 。 如 果 有 人 想 用 Python 
分 之 前 先 编写 和 运行 测试 ， 然 后 再 编写 最 少量 的 代码 让 测试 通过 。 也 就 ”做 测试 、 学 习 Django 或 者 想 使 用 
是 说 ， 你 将 学 会 应 用 TDD 理 念 ， 写 出 简洁 可 用 、 赏 心 悦 目的 代码 。 Selenium ， 我 极力 推荐 这 本 书 。 

要 使 开发 者 保持 头脑 清醒 ， 测 试 
在 这 个 过 程 中 ， 你 还 将 学 到 Django、Selenium、Git、jQuery 和 Mock 的 基 可 谓 至 关 重 要 。 Harry 完 成 了 一 项 
础 知识 ， 以 及 其 他 当前 流行 的 Web 开 发 技术 。 如 果 你 准备 提升 自己 的 不 可 思议 的 工作 ， 他 不 仅 吸引 了 我 


汪 Se 们 对 测试 的 关注 ， 而 且 还 探索 了 
清楚 地 演示 如 企 实现 简单 的 
Python 技 能 ， 本 书 将 清楚 地 演示 如 何 使 用 TDD 实 现 简 单 的 设计 切实 可 行 的 测试 实践 方案 。” 


通过 阅读 本 书 ， 你 将 : 一 一 Michael Foord 
四 深入 分 析 TDD 流 程 ， 包 括 “ 单 元 测试/ 编写 代码 ”循环 和 重 构 ， te 
加 使 用 单元 测试 检查 类 和 函数 ， 使 用 功能 测试 检查 浏览 器 中 的 用 户 

交互 ; “这 本 书 远 不 只 是 介绍 了 测试 驱动 

ed ed Re er 开发 ， 它 还 是 一 套 完整 的 最 佳 实 
目 学 习 何 时 以 及 如 何 使 用 模拟 对 象 ， 以 及 隔离 测试 和 整合 测试 的 优 tee 

缺点 ; 何 使 用 Python 开发 现代 Web 应 用 。 
卓 在 过 渡 服 务 器 中 测试 和 自动 部 署 ; 每 个 Web 开 发 者 都 应 该 阅读 这 
曙 测试 网 站 中 集成 的 第 三 方 插件 ， 志 ， 


Kenneth Reitz 
Python 软件 基金 会 特别 会 员 





四 使 用 持续 集成 环境 自动 运行 测试 。 





“我 们 学 习 Django 时 ， 真 希望 有 
Harry 的 这 本 书 。 这 本 书 内 容 紧 
凑 ， 环 环 相 操 ， 却 又 令 人 愉悦 ， 
精彩 地 介绍 了 Django 和 各 种 测试 

一 一 Daniel Greenfield 和 
Audrey Roy 


Two Scoops of Django 的 作者 


Harry J.W. Percival 目 前 就 职 于 PythonAnywhere LLP 公 司 ， 他 在 各 种 演讲 、 
研讨 会 和 开发 者 大 会 上 积极 推广 TDD。 他 在 利物浦 大 学 获得 计算 机 科学 硕 
士 学 位 ， 在 剑桥 大 学 获得 哲学 硕士 学 位 。 
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计算 机 /Web 开 发 /Python 
人 
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如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com ， 会 有 编辑 或 作 译 者 协助 
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